home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / commadio / robocom2 / robocom2.exe / ROBOCOMM.DOC < prev    next >
Text File  |  1992-02-12  |  197KB  |  4,760 lines
  1.  
  2.  
  3.  
  4.  
  5.         ┬─┬─────┐
  6.         │ │     │
  7.         │ ├───┬─┘ ┌┬──┐ ┬┬─┐  ┌┬──┐ ┌┬──┐ ┌┬──┐ ┌┬─┬─┐ ┌┬─┬─┐  (tm)
  8.         │ │   │   ││  │ │├─┴┐ ││  │ ││    ││  │ ││ │ │ ││ │ │
  9.         ┴─┴   ┴── └┴──┘ ┴┴──┘ └┴──┘ └┴──┘ └┴──┘ ┴┴ ┴ ┴ ┴┴ ┴ ┴
  10.  
  11.         The ultimate tool for unattended           ┬  ┌┐ ┌─┬┐
  12.         BBS communications.                        └──┤│ │ ││
  13.                                                       └┘o└─┴┘
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                (c) Copyright 1989-1992, Parsons Consulting
  21.  
  22.                            All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                       ================================
  62.                        ROBOCOMM 4.0 REGISTRATION FORM
  63.                       ================================
  64.  
  65.  
  66.                        Remit to:    Parsons Consulting
  67.                                     5020 S. Lake Shore Drive
  68.                                     Suite 3301
  69.                                     Chicago, IL  60615-3249
  70.                                     U.S.A.
  71.  
  72.         ------------------------------------------------------------------
  73.         | Item                          | Quantity |  Price |    Total   |
  74.         |-------------------------------|----------|--------|------------|
  75.         | Robocomm version 4.0          | ________ | $40.00 | __________ |
  76.         |                               |          |        |            |
  77.         | Printed Documentation         | ________ | $10.00 | __________ |
  78.         |                               |          |        |            |
  79.         | IL resident's sales tax       |          |   8%   | __________ |
  80.         |                               |          |        |            |
  81.         | Shipping (Outside of U.S.)    | ________ |  $5.00 | __________ |
  82.         |---------------------------------------------------|------------|
  83.         |                                                   |            |
  84.         |   Total amount enclosed                           | __________ |
  85.         ------------------------------------------------------------------
  86.  
  87.         Check desired disk format:    ( ) 5.25" OK      ( ) 3.5" Required
  88.                      Disk Density:    ( ) Low Required  ( ) High OK
  89.  
  90.         Payment by:  ( ) Check or money order (U.S. funds only)
  91.                      ( ) MasterCard
  92.                      ( ) Visa
  93.                      ( ) PO # ______________
  94.  
  95.         Card #: ____________________________________  Exp. Date: _________
  96.  
  97.  
  98.     Signature of card holder: ____________________________________________
  99.  
  100.  
  101.         Name:     ________________________________________________________
  102.  
  103.         Company:  ________________________________________________________
  104.  
  105.         Address:  ________________________________________________________
  106.  
  107.                   ________________________________________________________
  108.  
  109.                   ________________________________________________________
  110.  
  111.         Phone:    ________________________________________________________
  112.  
  113.        FLASH:  INSTANT GRATIFICATION REGISTRATION ONLINE AT GROUP ONE BBS!
  114.                Call Group One BBS and register with MasterCard or Visa and
  115.                receive your personalized ROBOUSR.DEF file immediately!
  116.                                >>>> 312-752-1258 <<<<
  117.     ______________________________________________________________________
  118.     Robocomm 4.0 User's Guide                                      Page  i
  119.  
  120.     -----------------
  121.     TABLE OF CONTENTS
  122.     -----------------
  123.  
  124.  
  125.     TECHNICAL SUPPORT ........................................2
  126.     WHAT IS ROBOCOMM? ........................................3
  127.     THE ROBOCOMM DISTRIBUTION FILES ..........................6
  128.     SYSTEM REQUIREMENTS ......................................7
  129.     CHECKLIST FOR A TROUBLE-FREE INSTALLATION ................8
  130.     GETTING STARTED ..........................................10
  131.     SPECIAL KEYS .............................................10
  132.     THE ROBO ENVIRONMENT VARIABLE ............................12
  133.     COMMUNICATIONS CONFIGURATION .............................15
  134.     UTILITY CONFIGURATION ....................................23
  135.     DATA AND LOG CONFIGURATION ...............................27
  136.     GENERAL CONFIGURATION OPTIONS ............................30
  137.     PC-PURSUIT CONFIGURATION .................................32
  138.     DIALING MACROS ...........................................34
  139.     SETTING UP DISPLAY COLORS ................................35
  140.     FILTER WORDS .............................................35
  141.     PREFERENCE WORDS .........................................36
  142.     SEARCH DIRECTORIES .......................................37
  143.     MANAGING THE SYSTEMS DIRECTORY ...........................38
  144.        ADDING SYSTEMS.........................................38
  145.        EDITING SYSTEMS........................................39
  146.        DELETING SYSTEMS.......................................43
  147.        RENAMING SYSTEMS.......................................43
  148.        VIEWING SYSTEM STATISTICS..............................43
  149.        EDITING SYSTEM NOTES...................................43
  150.     MANAGING PROMPT DEFINITIONS ..............................44
  151.        RESETTING DEFAULT PROMPTS..............................44
  152.        IMPORTING PROMPT DEFINITION FILES......................44
  153.        EXPORTING PROMPT DEFINITION FILES......................44
  154.     CREATING AND EDITING AGENDAS .............................45
  155.          SETTING ACTION DAYS .................................46
  156.          MOVING AGENDA ITEMS .................................46
  157.          GET QWK MAIL PACKET .................................47
  158.          SEND REPLY REP PACKET ...............................47
  159.          PCRELAY/MEGAMAIL TRANSFERS ..........................47
  160.          DOWNLOADING FILES ...................................48
  161.          POST CALL DOWNLOADED FILE PROCESSING ................49
  162.          UPLOADING FILES .....................................51
  163.          BROADCASTING FILES TO MULTIPLE BBS SYSTEMS ..........52
  164.          SCANNING FOR NEW FILES ..............................53
  165.          JUMP TO TERMINAL MODE ...............................53
  166.          CAPTURING COMMAND RESULTS ...........................54
  167.          DOWNLOADING PCBMAIL PACKETS .........................56
  168.          RUNNING EXTERNAL PROGRAMS ...........................57
  169.          EXECUTING SCRIPTS ...................................58
  170.             EDITING SCRIPT PARAMETERS.........................58
  171.     PREPARING THE BBS FOR YOUR FIRST ROBOCOMM CALL ...........60
  172.          PCBOARD BBS SETUP PROCEDURE .........................60
  173.          WILDCAT! BBS SETUP PROCEDURE ........................61
  174.     RUNNING AN AGENDA ........................................63
  175.          PREAGEN.BAT AND POSTAGEN.BAT PROCESSING .............63
  176.     ______________________________________________________________________
  177.     Robocomm 4.0 User's Guide                                      Page ii
  178.  
  179.  
  180.  
  181.  
  182.          WHILE AN AGENDA IS RUNNING ..........................64
  183.          PC PURSUIT DIALING ..................................64
  184.     USING THE ANSI TERMINAL ..................................66
  185.          DOORWAY MODE ........................................67
  186.          AUTOMATIC ZMODEM DOWNLOADS ..........................67
  187.          AUTOMATIC HS/LINK DOWNLOADS .........................68
  188.     VIEWING & MANAGING THE FILE DIRECTORIES ..................68
  189.          BULK DELETE .........................................69
  190.          DATABASE CLEAN UP ...................................69
  191.          FINDING FILES .......................................70
  192.          EDITING FILE DESCRIPTIONS ...........................70
  193.          TAGGING AND .........................................70
  194.          JUMPING AROUND ......................................71
  195.          DELETING ENTRIES ....................................71
  196.          ZAPPING THE DIRECTORY ...............................72
  197.          MOVING FILES OFFLINE ................................72
  198.          MOVING FILES ON-LINE ................................72
  199.          VIEWING DOWNLOADED FILES ............................72
  200.          TESTING DOWNLOADED FILES ............................72
  201.          IMPORTING NEW FILES LISTINGS FROM OTHER SOURCES .....73
  202.          WRITING TO PCBOARD FORMAT DIR FILES .................74
  203.     READING DOWNLOADED MAIL FILES ............................75
  204.     OPERATING ROBOCOMM FROM THE COMMAND LINE .................76
  205.     INTERPRETING AND VIEWING THE LOG .........................77
  206.     VIEWING CAPTURE (CAP) FILES ..............................78
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.     ______________________________________________________________________
  235.     Robocomm 4.0 User's Guide                                     Page iii
  236.  
  237.  
  238.  
  239.  
  240.                             DISCLAIMER OF WARRANTY
  241.  
  242.  
  243.     THIS SOFTWARE PROGRAM AND DOCUMENTATION ("ROBOCOMM") IS BEING  OFFERED
  244.     FOR  EVALUATION  PURPOSES  "AS  IS"  AND  WITHOUT  WARRANTIES  AS   TO
  245.     PERFORMANCE OR MERCHANT-ABILITY.  BY USING ROBOCOMM, YOU ARE EXPRESSLY
  246.     RELEASING DAN PARSONS  FROM ANY LIABILITY  RESULTING FROM  THE USE  OF
  247.     THIS SOFTWARE AND DOCUMENTATION.  THE USER MUST ASSUME THE ENTIRE RISK
  248.     OF USING ROBOCOMM.  BECAUSE OF  THE DIVERSITY OF CONDITIONS,  HARDWARE
  249.     AND OPERATING  ENVIRONMENTS  UNDER  WHICH ROBOCOMM  MAY  BE  USED,  NO
  250.     WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  THE USER  IS
  251.     ADVISED TO TEST  AND SUPERVISE ROBOCOMM  THOROUGHLY BEFORE RELYING  ON
  252.     IT.
  253.  
  254.  
  255.                                LICENSE AGREEMENT
  256.  
  257.     1) Robocomm is being distributed as Shareware.  This program is not
  258.        free.  You are granted a limited license to evaluate Robocomm for a
  259.        period not to exceed 30 days.  After 30 days, you must either pay
  260.        for and register your copy of Robocomm, or immediately discontinue
  261.        its use and remove it from your computer.
  262.  
  263.     2) You may keep as many backup copies of Robocomm as you wish, but you
  264.        may not run Robocomm simultaneously on more than one computer.
  265.        Additionally, you are granted the right to share Robocomm with
  266.        others, as long as you distribute the Robocomm archive exactly as
  267.        you received it, with all associated files included.  REGISTERED
  268.        USERS MAY NOT DISTRIBUTE THE SEPARATE FILE ROBOUSR.DEF.
  269.  
  270.     3) Under no circumstances may you charge a fee or receive any other
  271.        form of consideration for distributing the Robocomm files without
  272.        express written consent from the copyright holder, Dan Parsons.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.     ______________________________________________________________________
  293.     Robocomm 4.0 User's Guide                                       Page 1
  294.  
  295.  
  296.  
  297.  
  298.  
  299.        Technical Support
  300.  
  301.     If you are having problems operating Robocomm, please review the
  302.     ROBO-FAQ.TXT file, which is a text file containing the answers to many
  303.     Frequently Asked Questions.  It's quite likely that you'll fiind your
  304.     answer there.
  305.  
  306.     To contact the author of Robocomm directly, send your comments and
  307.     questions to Dan Parsons at GROUP ONE BBS, the customer support BBS
  308.     for Robocomm.  Located in Chicago, Illinois, this PCBoard BBS runs 24
  309.     hours a day on an HST 14400bps modem.
  310.  
  311.  
  312.  
  313.  
  314.                  GROUP ONE BBS Data Line: (312) 752-1258
  315.  
  316.  
  317.  
  318.  
  319.     For general technical support, look for a ROBOCOMM echo mail support
  320.     conference on a BBS near you.  Currently, Robocomm support conferences
  321.     are active on:
  322.  
  323.                  * ILink
  324.                  * NorthAmerinet
  325.                  * PlanoNet
  326.                  * RIME
  327.                  * Smartnet
  328.                  * U'NI Net
  329.  
  330.     Make sure your local Sysop knows about the availability of these
  331.     conferences!
  332.  
  333.     Via CompuServe Mail:          Via U.S. Mail:
  334.  
  335.     72167,3662                    Parsons Consulting
  336.                                   5020 S. Lake Shore Drive, Suite 3301
  337.                                   Chicago, IL  60615
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.     ______________________________________________________________________
  351.     Robocomm 4.0 User's Guide                                       Page 2
  352.  
  353.  
  354.  
  355.  
  356.  
  357.        What Is Robocomm?
  358.  
  359.     Robocomm is an integrated communications environment which allows you
  360.     to create "Agendas" composed of "Things to Do" on an unlimited number
  361.     of PCBoard and Wildcat BBS systems.  Robocomm is a comprehensive
  362.     software tool, designed exclusively to enhance communications with
  363.     bulletin board systems.   The program contains built-in support for
  364.     PCBoard and Wildcat! BBS systems.  The following is a sample of the
  365.     things that you can tell Robocomm to do for you:
  366.  
  367.     *  Reliably transfer message and reply packets with support for a wide
  368.        variety of mail doors for offline message reading and replying.
  369.        Robocomm will automatically rename and delete message packets to
  370.        keep between 0 and 9 old mail packets for each system you call.
  371.  
  372.     *  Sysops can reliably transfer mail packets with other systems during
  373.        their events, and also pick up other files without constantly
  374.        tinkering with scripts.
  375.  
  376.     *  Scan for "New Files" since any date and in any number of the BBS
  377.        system's file directories from any conference.  Robocomm
  378.        automatically adds the results of your file scans to its databases
  379.        for easy point-and-shoot selection of files to download.
  380.  
  381.     *  Upload and Download files to and from any conference.  Files to
  382.        download and upload can be tagged and selected through a "Point and
  383.        Shoot" interface.  Alternately, file transfers can be performed via
  384.        ProDoor.   Multiple files can be uploaded or "Broadcast" to many
  385.        systems just by entering a single agenda command.  You can even
  386.        automatically download password protected files!
  387.  
  388.     *  Automatically use your favorite scanning utility scan for viruses
  389.        in files immediately after downloading them and insert customized
  390.        ZIP comments containing download date, time, file description, and
  391.        source BBS.
  392.  
  393.     *  Automatically export the file name, size, date and description to a
  394.        standard format PCBoard and Wildcat! file directory files.  Sysops
  395.        can have Robocomm download files, scan them for viruses, insert
  396.        customized ZIP comments and write an entry to their new files lists
  397.        all automatically!
  398.  
  399.     *  Capture the results of BBS commands to a text file for review after
  400.        logoff.  This is useful for reviewing messages from BBS systems
  401.        which do not run a mail door, as well as capturing bulletins and
  402.        news files for offline reading. Join any conference before issuing
  403.        the command results to capture.
  404.  
  405.     *  Download compressed mail captures from PCBoard.  Compressed
  406.        "PCBMail" packets are automatically renamed and numbered as they
  407.        are received.
  408.     ______________________________________________________________________
  409.     Robocomm 4.0 User's Guide                                       Page 3
  410.  
  411.  
  412.  
  413.  
  414.  
  415.     *  Run other DOS programs at any time while on-line with a BBS.
  416.  
  417.     *  "Jump to Terminal" - to jump to ANSI terminal mode and sound an
  418.        alarm to alert you.
  419.  
  420.     *  Execute Script Files to perform virtually any task imaginable.
  421.        Robocomm contains an extensive script language which can be used to
  422.        create generic, customizable agenda items that can accept
  423.        parameters from users to be evaluated at runtime.  You can even
  424.        create Logon Scripts to automate on-line tasks with BBS systems
  425.        other than PCBoard and Wildcat.
  426.  
  427.     Any number or combination of these "agenda items" can be added for an
  428.     unlimited number of PCBoard systems - all in the same automated
  429.     agenda!  In addition to these automated features, Robocomm offers:
  430.  
  431.     *  Support for the PC Pursuit communication network with an
  432.        integrated, ultra-reliable PC Pursuit dialer.  Monthly PC Pursuit
  433.        usage is automatically tracked and totaled for you.  Input up to 3
  434.        phone numbers for each BBS system.
  435.  
  436.     *  Full support for Microsoft compatible mice.
  437.  
  438.     *  Internal support for Zmodem, Ymodem and Ymodem-G file transfer
  439.        protocols.
  440.  
  441.     *  16550 UART support for ultra-reliable file transfers while multi-
  442.        tasking with programs such as Windows and Desqview.
  443.  
  444.     *  Complete logging of on-line sessions at any of three selectable
  445.        detail levels.
  446.  
  447.     *  A super fast text file viewer for access to log files and captured
  448.        BBS output.
  449.  
  450.     *  An internal editor for modifying file descriptions and BBS notes.
  451.  
  452.     *  An ANSI compatible terminal for regular "hands on" calls to BBS
  453.        systems, including popular features, such as:
  454.  
  455.          *  Logging of incoming text to capture files and the printer.
  456.          *  DOORWAY mode for enhanced control of compatible remote
  457.             systems.
  458.          *  Integrated Demon-Dialer
  459.          *  Automatic Zmodem and HS/Link download detection.
  460.  
  461.     *  Robocomm includes a timer capability that allows you to set the
  462.        time and day that it should begin executing an agenda.
  463.  
  464.     *  Robocomm can be run entirely from command line switches.  In this
  465.        way, Robocomm can be used to transfer network mail and also get
  466.     ______________________________________________________________________
  467.     Robocomm 4.0 User's Guide                                       Page 4
  468.  
  469.  
  470.  
  471.  
  472.        files during a bulletin board's nightly event.
  473.  
  474.     *  All of the prompts that Robocomm looks for while performing its on-
  475.        line magic are individually configurable for each BBS.
  476.  
  477.     *  Full compatibility with a wide variety of PCBoard and Wildcat add-
  478.        in products, such as ProLogon, ProDoor, DDoor, TextView, MegaMail,
  479.        PCRelay, NetMail, Qmail, RoseMail, TomCat and MarkMail.
  480.        Automatically detects any combination of ProLogon, Ddoor, PCBoard
  481.        and ProDoor when logging on to PCBoard style systems and reacts
  482.        accordingly with no special configuration.
  483.  
  484.     *  A viewable copy of your "Statistics" for each bulletin board that
  485.        you call using Robocomm.  Keep tabs on the Upload/Download ratio.
  486.        With Robocomm, It's now easier than ever to keep your file transfer
  487.        ratios in line.
  488.  
  489.     *  Access to your mail reader program from the Robocomm main menu
  490.        using Robocomm's virtual memory management.
  491.  
  492.     *  Hot key access to a large DOS shell -- all but 8K of original RAM
  493.        before starting Robocomm
  494.  
  495.     *  A super-fast internal ASCII file viewing utility, automatically
  496.        configured to view capture and log files at the touch of a button.
  497.  
  498.     *  Comprehensive, context-sensitive on-line help.
  499.  
  500.     *  The ability to interrupt a running agenda and continue from where
  501.        you left off later.  You can also tell Robocomm to remain on-line
  502.        after completing its automated functions for hands-on work.
  503.  
  504.     *  A multi-BBS files database.  The database size is limited only by
  505.        your available disk space and can be instantly sorted by date, BBS
  506.        or file name.  Commands for keyword searches of the database are
  507.        available.  Full length file descriptions are supported.
  508.  
  509.     *  A database of all files downloaded or uploaded with Robocomm. From
  510.        this directory, you can point-and-shoot to call your favorite
  511.        compressed file viewer to look at a file's contents and even create
  512.        a temporary directory to scan for viruses and test out files.  File
  513.        descriptions from this database are automatically used when
  514.        creating "Upload" agenda items.
  515.  
  516.     *  An integrated offline file cataloging system.  Move files offline
  517.        to floppy disks and keep just the descriptions and vital
  518.        information on hand for future reference.  One keystroke brings the
  519.        files back on-line when the time comes to upload or use the files.
  520.  
  521.  
  522.  
  523.  
  524.     ______________________________________________________________________
  525.     Robocomm 4.0 User's Guide                                       Page 5
  526.  
  527.  
  528.  
  529.  
  530.        The Robocomm Distribution Files
  531.  
  532.     The following files should have been in your compressed distribution
  533.     files.  If you pass along Robocomm to others, you MUST use the
  534.     original ROBO40-A.ZIP and ROBO40-B.ZIP files!
  535.  
  536.     README.1ST     Important supplemental information
  537.     ROBOCOMM.HST   A quick summary of major new features in Robocomm 4.0
  538.     ORDER.FRM      Order form for registering Robocomm
  539.     ROBO-FAQ.TXT   Frequently Asked Questions (and answers) text file
  540.     ROBOCOMM.EXE   Robocomm program file
  541.     ROBOCOMM.OVL   Robocomm overlay file
  542.     ROBOCOMM.ICO   Windows 3.x icon
  543.     ROBOCOMM.DOC   This documentation file
  544.     SCRIPT.DOC     Technical documentation for Robocomm's script language
  545.     UPGRADE.DOC    Instructions for upgrading from previous versions
  546.     HELP.DBF       Data file for help screens
  547.     HELP.DBV       Data file for help screens
  548.     I_BBS.DBF      Install data file for BBS systems
  549.     I_AGENDA.DBF   Install data file for agendas
  550.     I_NEW.DBF      Install data file for new files from BBS systems
  551.     I_UP.DBF       Install data file for downloaded files
  552.     I_TAGEND.DBF   Temporary storage datafile for agenda processing
  553.     HS-AUTO.BAT    Batch file to implement auto-HS/Link downloads
  554.     MAKELIST.BAT   Batch file to assist in iimporting files
  555.     TESTFILE.BAT   Sample batch file for testing downloaded files from
  556.                    within Robocomm's "Downloads" directory.
  557.     ROBOSZ.BAT     Sample batch file for DSZ Zmodem send
  558.     ROBORZ.BAT     Sample batch file for DSZ Zmodem receive
  559.     MEGAIN.BAT     MegaMail receive file (Needs editing)
  560.     MEGAOUT.BAT    MegaMail send file (Needs Editing)
  561.     FIXFILE.BAT    Batch file used to insert a custom ZIPfile comment into
  562.                    downloads.
  563.     COMMENT.FRM    Pre-merge form used to create ZIPfile comments.
  564.     ROBOFONT.VGA   Robocomm's customized VGA font file
  565.     EXITFONT.EXE   VGA Font control utility
  566.  
  567.     DEFAULT.PPF    Robocomm prompt definition files
  568.     MARKMAIL.PPF   .
  569.     ROSEMAIL.PPF   .
  570.     CAM-MAIL.PPF   .
  571.     ALLPRO.PPF     .
  572.     DEFAULT.WPF    .
  573.  
  574.     PCB_SET.RS     Sample script files
  575.     BB_W.RS        .
  576.     BB_D.RS        .
  577.     WCRELAY.RS     .
  578.  
  579.  
  580.  
  581.  
  582.     ______________________________________________________________________
  583.     Robocomm 4.0 User's Guide                                       Page 6
  584.  
  585.  
  586.  
  587.  
  588.  
  589.     ROBOUSR.DEF    Registered users receive this personalized file on
  590.                    their diskette, which removes the need to press a
  591.                    random key on the opening screen, imbeds their name and
  592.                    serial number on the title screen, changes the on-line
  593.                    message to "Robocomm 4.0 Registered User," removes the
  594.                    questions displayed before quitting and allows them to
  595.                    run several Robocomm add-on utilities, such as
  596.                    REXCLUDE.EXE.
  597.  
  598.     After the first time you run ROBOCOMM.EXE the following files will
  599.     have been created.  These files are always created automatically if
  600.     they are not found when Robocomm starts:
  601.  
  602.     *.NTX               Index files for the data files listed above
  603.     ROBOCOMM.MEM   Memory file which stores Robocomm's configuration
  604.                    information.  To reset your customized Robocomm to the
  605.                    default configuration, just delete this file and
  606.                    restart Robocomm.
  607.     EXITSTAT.MEM   Used by Robocomm to test index file integrity.
  608.     PCP_TIME.MEM   Stores your cumulative PC Pursuit usage.
  609.     ROBOCOMM.DBV   Stores a variety of variable length program data
  610.  
  611.  
  612.  
  613.        System Requirements
  614.  
  615.     Robocomm has been thoroughly tested and has been found to run reliably
  616.     on PCs which are 100% IBM compatible and with modems which conform to
  617.     the Hayes command set.  Robocomm supports communications speeds from
  618.     300 to 38400 baud.  You will need at least 512K of RAM free to run
  619.     Robocomm reliably.  Optimal execution speed is possible on systems
  620.     with 560K or more RAM free. A hard disk with sufficient free disk
  621.     space is required .  If expanded memory is available on your system,
  622.     Robocomm will attempt to use it for virtual memory and when swapping
  623.     to run outside utilities.  EMS is not required, however.  See the
  624.     configuration section for details.
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.     ______________________________________________________________________
  641.     Robocomm 4.0 User's Guide                                       Page 7
  642.  
  643.  
  644.  
  645.  
  646.  
  647.        Checklist for a Trouble-Free Installation
  648.  
  649.     The following checklist is intended to assist people who already know
  650.     their way around PCBoard and Wildcat BBS systems and know how to use
  651.     DOS. It will enable you to get set up quickly and without any hassles.
  652.     Once you have Robocomm up and running, please do read the rest of this
  653.     documentation.  There are several features in Robocomm that you might
  654.     miss out on if you don't read on!
  655.  
  656.     ____ Extract all files from the ROBO40-A.ZIP and ROBO40-B.ZIP files
  657.          into a separate \ROBO subdirectory.  If you are upgrading from a
  658.          previous version, unzip the files into your existing Robocomm
  659.          subdirectory.  If PKUNZIP prompts you for permission to overwrite
  660.          any files, go ahead and answer yes.  There is an automatic
  661.          conversion process built into Robocomm 4.0.
  662.  
  663.  
  664.  
  665.  
  666.          NOTE:     Automatic upgrades are not possible from Robocomm
  667.                    versions prior to version 3.0.  If you are using any
  668.                    prior version, other than Robocomm 3.0 or 3.1, you will
  669.                    need to create a new Robocomm 4.0 installation and re-
  670.                    enter your BBS information into it.
  671.  
  672.  
  673.  
  674.  
  675.          NOTE: It is not necessary to overwrite the ROBOS?.BAT and
  676.          ROBOR?.BAT files.  If you have modified the file transfer batch
  677.          files that came with an earlier version of Robocomm, you can use
  678.          them with Robocomm 4.0.
  679.  
  680.     ____ Add your Robocomm subdirectory to your DOS PATH setting.
  681.  
  682.  
  683.  
  684.  
  685.          NOTE:     You must start Robocomm from within it's own
  686.                    subdirectory.  You are adding Robocomm to the PATH
  687.                    because Robocomm may change directories during
  688.                    operation and DOS may need to find some of the batch
  689.                    files contained in the Robocomm directory.
  690.  
  691.  
  692.  
  693.  
  694.     ____ Make sure that your CONFIG.SYS contains a setting which enables a
  695.          FILES setting of 39 or more. (Odd numbers are recommended,
  696.          because of a bug in some older versions of DOS)
  697.  
  698.     ______________________________________________________________________
  699.     Robocomm 4.0 User's Guide                                       Page 8
  700.  
  701.  
  702.  
  703.  
  704.     ____ If you changed your CONFIG.SYS or AUTOEXEC.BAT, you should re-
  705.          boot your computer now, so that the changes will take effect.
  706.  
  707.     ____ Make sure PKUNZIP.EXE is installed on your system.  If you decide
  708.          not to place it in your Robocomm directory, then it must be
  709.          available in your DOS PATH statement.
  710.  
  711.     ____ If you have expanded memory to spare and would like to speed up
  712.          Robocomm's operations even further, add a ROBO environment
  713.          variable to specify the amount of EMS to use.  By default,
  714.          Robocomm will allocate and use 512K of EMS at startup.  However,
  715.          you can speed operations up even more by instructing Robocomm to
  716.          allocate more. For example, typing the following at the DOS
  717.          prompt before starting Robo will instruct Robocomm to use 1
  718.          Megabyte of expanded memory for virtual memory and buffering its
  719.          index files.
  720.  
  721.               SET ROBO=E1024
  722.  
  723.          The range of acceptable values for this environment variable is 0
  724.          to 8192.  If you have EMS memory, you are strongly encouraged to
  725.          allow Robocomm to use at least some of it.  Robocomm's virtual
  726.          memory operations are much quicker when using EMS, as opposed to
  727.          hard disk space.
  728.  
  729.  
  730.  
  731.  
  732.          NOTE:     Robocomm will also use EMS or XMS memory to swap itself
  733.                    out when shelling to DOS or running outside utility
  734.                    programs.  Any memory specify for allocation in the
  735.                    ROBO environment variable will be unavailable for
  736.                    swapping.
  737.  
  738.  
  739.  
  740.  
  741.     ____ Type ROBOCOMM to start up Robocomm 4.0 for the first time. There
  742.          will be a slight delay while Robocomm creates some needed files.
  743.          If you are upgrading, Robocomm will convert your old data files.
  744.  
  745.     ____ Go to the four CONFIGURATION screens and enter in the required
  746.          configuration information.  These options are covered in detail
  747.          later in this user's guide if you have questions. Remember to use
  748.          [F1] for on-line help if you need assistance.
  749.  
  750.  
  751.  
  752.  
  753.          NOTE:     If you are upgrading, it is essential that you visit
  754.                    the General Options Configuration screen.  Once there,
  755.                    you need to answer a couple of questions that Wildcat!
  756.     ______________________________________________________________________
  757.     Robocomm 4.0 User's Guide                                       Page 9
  758.  
  759.  
  760.  
  761.  
  762.                    systems may ask of Robocomm during log on.
  763.  
  764.  
  765.  
  766.  
  767.     ____ Go to the Directory-BBS screen and set up entries for the BBS
  768.          systems you intend to call with Robocomm.  If the BBS you add is
  769.          running PCBoard 14.5 and you will be using the Qmail 4.0 door,
  770.          then the default PCBoard prompt definitions will work.  If not,
  771.          you will need to "import" an alternative prompt set.  See the
  772.          "Managing the Systems Directory" section of this manual for
  773.          further details.
  774.  
  775.     ____ Make sure to read the section that deals with "Setting the BBS up
  776.          for your first Robocomm call."  It will help you get off on the
  777.          right foot.
  778.  
  779.     ____ Follow along with the CREATING AN AGENDA section of this User's
  780.          Guide to make your first agenda.
  781.  
  782.     ____ Make sure the BBS systems you are going to call have your file
  783.          and mail transfer protocols set to match the batch files you
  784.          specified on the DIRECTORY-BBS screen.  Robocomm allows you to
  785.          input the words ZMODEM, YMODEM-G and YMODEM to use any of its
  786.          internal protocols.  If you want to use an external protocol
  787.          driver, enter the name of the batch file to call in the space
  788.          provided.
  789.  
  790.  
  791.  
  792.        Getting Started
  793.  
  794.     To start Robocomm, enter the \ROBO subdirectory and type "ROBOCOMM" at
  795.     the DOS prompt.  The program will load and display its opening screen.
  796.     There may be a slight delay the first time you start Robocomm since
  797.     the program will need to create several files on your disk.
  798.  
  799.     NAVIGATING THE MENUS - First a word about Robocomm's user interface.
  800.     Most everything is done with Bounce Bar menus. The arrow keys will
  801.     move the highlight bar.  When the option you want is highlighted,
  802.     press [Enter].  Alternatively, you can press the highlighted letter in
  803.     any menu option to execute it.
  804.  
  805.     GIVE ME A HINT - The bottom line of all screens is devoted to the
  806.     display of "Hint" lines.  If you find your self feeling confused or
  807.     you want a quick summary of active keys, look at the bottom line of
  808.     the screen!
  809.  
  810.     SPECIAL KEYS - Several keys have special functions in Robocomm.
  811.  
  812.     [F1]      Context sensitive on-line help can be accessed at any point
  813.               during the operation of Robocomm.  Simply go to the place
  814.     ______________________________________________________________________
  815.     Robocomm 4.0 User's Guide                                      Page 10
  816.  
  817.  
  818.  
  819.  
  820.               you want help and press [F1] to access the help system.
  821.               Help text is presented in pages
  822.  
  823.               The information in the help window can be scrolled with the
  824.               arrow keys and [PgUp] & [PgDn].  [Home] will take you to the
  825.               first line of the help screen and [End] will take you to the
  826.               last line.  You can move the help window to a different
  827.               location  on the screen by pressing holding down either
  828.               [Shift] key and pressing an arrow key.  The location you
  829.               leave the screen in will be memorized by Robocomm and the
  830.               help window for will be opened in that spot the next time
  831.               you press [F1].  To close the help window, press [Enter],
  832.               [Esc] or [F1].
  833.  
  834.     [F2]      At the main menu, pressing [F2] will toggle on and off a
  835.               status display.  The display contains information concerning
  836.               your swap drive status,  currently set agenda, memory usage
  837.               and your cumulative PC Pursuit usage.
  838.  
  839.     [F5]      From the BBS-Directory or either of the File Directories,
  840.               pressing [F5] will call the external batch file,
  841.               ANALYZE.BAT, which can be used to run a program designed to
  842.               report on the data in the Robocomm's TRANSFER.LOG file.
  843.  
  844.     [F7]      To shell to DOS at any time during the operation of Robocomm
  845.               (except while agendas are running) press [F7]. Robocomm will
  846.               swap itself to disk or expanded memory and call a copy of
  847.               your command processor as defined by your COMSPEC
  848.               environment variable.
  849.  
  850.     [F8]      Pressing [F8] at any point during Robocomm execution will
  851.               allow you to view your configured file browsing utility to
  852.               view your most recent Robocomm agenda LOG file.
  853.  
  854.     [F9]      Pressing [F9] at any point during Robocomm execution will
  855.               present you with a pop-up list of capture files in the
  856.               current directory (capture files have a .CAP extension) When
  857.               you select a file from this list, Robocomm will run your
  858.               configured file browsing utility to view the capture file.
  859.  
  860.  
  861.  
  862.  
  863.               HINT:     If you would like to have this documentation file
  864.                         available while using Robocomm, just rename it to
  865.                         ROBOCOMM.CAP and you will be able to browse
  866.                         through it while running Robocomm by pressing the
  867.                         [F9] key and choosing ROBOCOMM.CAP from the pop-up
  868.                         list.
  869.  
  870.  
  871.  
  872.     ______________________________________________________________________
  873.     Robocomm 4.0 User's Guide                                      Page 11
  874.  
  875.  
  876.  
  877.  
  878.  
  879.     [F10]     If Robocomm is asking you for some information, such as an
  880.               agenda name, BBS ID or file name, you can always pop up a
  881.               window to browse through possible responses by pressing
  882.               [F10].
  883.  
  884.     [Esc]     At any point during Robocomm operations, pressing [Esc] will
  885.               back you up one menu level.
  886.  
  887.  
  888.     FIELD EDITING KEYS - Whenever Robocomm asks you to type in information
  889.     into an on screen data entry field, the following keys are active:
  890.  
  891.     [Ctrl-Y]            Delete all characters from the cursor position
  892.                         forward.
  893.     [Ctrl-Left Arrow]   Jump to the previous word.
  894.     [Ctrl-Right Arrow]  Jump to the next word.
  895.     [Ins]               Toggle insert mode.
  896.     [Del]               Delete the character on the cursor
  897.     [Home]              Jump to the first character
  898.     [End]               Jump to the last Character
  899.  
  900.  
  901.     SCROLLING KEYS - Whenever Robocomm is presenting you with a list of
  902.     items in a scrolling window the following keys are active:
  903.  
  904.     Up & Down Arrows    Scroll to the previous/next item
  905.     [PgUp]              Move a full screen of items backwards
  906.     [PgDn]              Move a full screen of items forward
  907.     [Ctrl-PgUp]         Move to the first item in the list
  908.     [Ctrl-PgDn]         Move to the last item in the list.
  909.  
  910.  
  911.  
  912.        The ROBO Environment Variable
  913.  
  914.  
  915.  
  916.  
  917.          NOTE:     The following discussion of the ROBO environment is
  918.                    fairly technical in nature.  None of it is required to
  919.                    get Robocomm running in a normal installation.  If you
  920.                    are uncomfortable with the material in this section,
  921.                    just skip ahead to the next section.
  922.  
  923.  
  924.  
  925.  
  926.     Many aspects of Robocomm's runtime behavior can be controlled via the
  927.     ROBO environment variable. To set this variable, add a line to your
  928.     AUTOEXEC.BAT file in the following format:
  929.  
  930.     ______________________________________________________________________
  931.     Robocomm 4.0 User's Guide                                      Page 12
  932.  
  933.  
  934.  
  935.  
  936.     SET ROBO=<command>;<command>;<command>
  937.  
  938.     The following commands are available:
  939.  
  940.     NOMOUSE      Disables mouse usage.
  941.  
  942.     NO16550      Disables 16550 UART usage.
  943.  
  944.     Ennn         Allocates a fixed amount of Expanded memory to be used by
  945.                  Robocomm.  Expanded memory is used for database buffering
  946.                  and virtual memory storage space.  The default value is
  947.                  512K.  You may set this value from 0 to 16 megabytes.
  948.                  Robocomm really shines when sufficient EMS memory is made
  949.                  available to it.
  950.  
  951.  
  952.  
  953.  
  954.                    NOTE:     The E command does not control swapping to
  955.                              EMS to run outside programs,  If EMS is
  956.                              available to Robocomm and has not previously
  957.                              been allocated via the E command it will be
  958.                              used for swapping, unless the NOEMSSWAP
  959.                              command is included in the ROBO environment
  960.                              variable.
  961.  
  962.  
  963.  
  964.  
  965.  
  966.     /OP1         Enables the use of the EMS page frame to hold overlay
  967.                  data.  Setting this option is a good idea if you have an
  968.                  expanded memory manager installed.  However, it is
  969.                  possible that this option will not be compatible with
  970.                  your particular EMS environment.  If Robocomm hangs
  971.                  during operation or other erratic behavior is observed,
  972.                  please remove the /OP1 option from your ROBO environment
  973.                  variable.  Do not attempt to use this option when QEMM's
  974.                  "Stealth" feature is active.
  975.  
  976.     /OU1         Enables the use of upper memory blocks (UMBs) for overlay
  977.                  data.  To use this option, your system must be configured
  978.                  with a UMB provider driver, such as HIMEM.SYS or QEMM.SYS
  979.                  and you must have a contiguous area of upper memory
  980.                  available which is at least as large as the configured
  981.                  overlay opsize.  (See the /OO command below)
  982.  
  983.     /OOnn        Sets the amount of memory, in kilobytes, that will be
  984.                  used to hold overlay data This value may be set from 30
  985.                  to 90.  The default value is 50.  Modifying this value is
  986.                  not recommended unless you are asked to do so by a
  987.                  Robocomm technical support representative
  988.     ______________________________________________________________________
  989.     Robocomm 4.0 User's Guide                                      Page 13
  990.  
  991.  
  992.  
  993.  
  994.  
  995.     SWAPPATH:    This command sets the location for Robocomm's virtual
  996.                  memory management (VMM) swap file.  Robocomm always
  997.                  creates this file, but will not actually use it unless
  998.                  insufficient EMS memory is available for current
  999.                  operations.  To use this option, simply enclose the
  1000.                  desired path within quotes.  For example,
  1001.  
  1002.                    SWAPPATH:"C:\TEMP"
  1003.  
  1004.                  instructs Robocomm to create its temporary VMM files in
  1005.                  the \TEMP subdirectory of your hard disk.  If you have a
  1006.                  large RAM disk, you might want to use this for your swap
  1007.                  files.
  1008.  
  1009.  
  1010.     NOEMSSWAP Disables swapping to EMS memory during DOS shell operations.
  1011.  
  1012.     NOXMSSWAP Disables swapping to XMS memory during DOS shell operations.
  1013.  
  1014.  
  1015.     Examples:
  1016.  
  1017.          SET ROBO=E1024;/OP1;SWAPPATH:"C:\TEMP"
  1018.  
  1019.          This environment variable tells Robocomm to use 1 megabyte of
  1020.          memory for index buffering and virtual memory,, to use the EMS
  1021.          page frame for its overlay area (thereby freeing up 50K of
  1022.          "conventional" memory) and to place any VMM swap files created in
  1023.          the \TEMP directory.  (It's very unlikely that a VMM swap file
  1024.          would be created with 1 megabyte of EMS available).
  1025.  
  1026.          SET ROBO=E0;/OU1;NOEMSSWAP;NOMOUSE;SWAPPATH:"D:\"
  1027.  
  1028.          This environment variable disables all expanded memory usage and
  1029.          places the overlay area into an upper memory block.  The mouse is
  1030.          disabled and any VMM swap files would be written to the D:\
  1031.          directory.  (This is probably not a good environment for
  1032.          Robocomm.  You should always strive to make EMS available to
  1033.          Robocomm is possible.)
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.     ______________________________________________________________________
  1047.     Robocomm 4.0 User's Guide                                      Page 14
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.        Configuration
  1054.  
  1055.     By using the "Configure" option from the main menu, you can access
  1056.     Robocomm's configuration screens, which allow you to specify options
  1057.     specific to your system.  In most instances, Robocomm's default values
  1058.     will work fine.  However, you probably will want to look over the
  1059.     options to optimize performance on your system.
  1060.  
  1061.  
  1062.        Communications Configuration
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.     From the main menu, select the Configure option, followed by
  1083.     Communications.  You will be presented with a screen allowing you to
  1084.     set the following options:
  1085.  
  1086.     DEFAULT BAUD RATE - Normally, this setting should be set to the
  1087.     highest baud rate your modem supports.  Pressing [Enter] will toggle
  1088.     the available baud rates from 300-38400 baud.  The baud rate you
  1089.     specify will be used when Robocomm initializes your modem before
  1090.     running an agenda or when entering the interactive terminal mode from
  1091.     the main menu.
  1092.  
  1093.     MODEM INITIALIZATION STRING - These are the characters that will be
  1094.     sent to your modem to tell it how to communicate with Robocomm.  To
  1095.     send a carriage return, use an "!".  To cause Robocomm to pause for
  1096.     half a second, use the "~" character.  In order to work with Robocomm,
  1097.     your modem must be configured in the following way:
  1098.  
  1099.          COMMAND ECHO STATUS - The "E1" in the default initialization
  1100.          string instructs the modem to echo commands entered back to
  1101.          Robocomm.  This "command echoing" will be needed if you send
  1102.          commands directly to the modem using the ANSI terminal.
  1103.  
  1104.     ______________________________________________________________________
  1105.     Robocomm 4.0 User's Guide                                      Page 15
  1106.  
  1107.  
  1108.  
  1109.  
  1110.          VERBAL RESPONSE CODES - The "V1" in the default initialization
  1111.          string tells your modem to respond to the commands Robocomm send
  1112.          it with verbal messages.  For example, the modem will respond
  1113.          with "CONNECT" when it has established communications with
  1114.          another modem or "BUSY" when it senses a busy signal.
  1115.  
  1116.          QUIET MODE OFF - The "Q0" ensures that response codes will be
  1117.          sent from your modem.
  1118.  
  1119.          RESPONSE CODE LEVEL - The "X4" in the initialization string sets
  1120.          the level of response codes that your modem will return. In most
  1121.          instances, you should set this value to the highest level
  1122.          supported by your modem.  Robocomm will respond to the following
  1123.          response codes:
  1124.  
  1125.  
  1126.           CONNECT       The third option on the Communications
  1127.                         Configuration screen allows you to specify
  1128.                         your modem's connect string.  The default,
  1129.                         "CONNECT" will work with all Hayes compatible
  1130.                         modems. Do not specify a baud rate in the
  1131.                         connect code, as in "CONNECT 2400".  Robocomm
  1132.                         assumes that it has connected to the BBS at
  1133.                         the baud rate you have specified for the
  1134.                         system.
  1135.  
  1136.           BUSY          Robocomm will attempt to redial this system or
  1137.                         the next system in the queue, depending on
  1138.                         your configuration.
  1139.  
  1140.           NO DIALTONE   Robocomm will hang up and attempt to dial
  1141.                         again, incrementing the dial counter by one.
  1142.  
  1143.           NO CARRIER    Robocomm will attempt to redial this system or
  1144.                         the next system in the queue, depending on
  1145.                         your configuration.  Receiving this response
  1146.                         code also increments the FAILED CALL counter.
  1147.                         See details later in this section.
  1148.  
  1149.           VOICE         If your modem supports this response code,
  1150.                         Robocomm will hang up, remove the number from
  1151.                         the dialing queue and make a notation
  1152.                         indicating a voice answer in the log file.
  1153.  
  1154.           ERROR         Robocomm will reset the modem, re-send the
  1155.                         initialization string and attempt to dial
  1156.                         again.  If three consecutive ERROR results are
  1157.                         received, Robocomm will abort the current
  1158.                         agenda and make a notation in the log file
  1159.  
  1160.  
  1161.          MONITOR SPEAKER CONTROL - The "M0" in the default initialization
  1162.     ______________________________________________________________________
  1163.     Robocomm 4.0 User's Guide                                      Page 16
  1164.  
  1165.  
  1166.  
  1167.  
  1168.          string instructs your modem to run in silent mode.  If you would
  1169.          like to hear the results of Robocomm's dial attempts, change the
  1170.          "M0" to "M1".
  1171.  
  1172.          DATA-CARRIER-DETECT (CD) - Because Robocomm is designed for
  1173.          unattended operation, it really needs to be sure that it knows
  1174.          EXACTLY what the status of your modem is at all times.  To do
  1175.          this, make sure that your modem is set up to correctly follow the
  1176.          status of the "carrier detect."  Most modems come from the
  1177.          factory with this feature disabled.  In other words, CD is forced
  1178.          "True" at all times.  Usually, you can cause the modem to
  1179.          correctly track CD with a DIP switch setting or a modem command.
  1180.          If Robocomm gives you an error message when attempting to hang up
  1181.          your phone, check your modem manual to see what must be done to
  1182.          get CD operating properly. In the case of modems which support
  1183.          the Hayes "&" extended command set, adding the command "&C1" to
  1184.          the initialization string will solve the problem.
  1185.  
  1186.          DATA-TERMINAL-READY (DTR) - Make sure that your modem is set up
  1187.          to respond to changes in the DTR status by dropping carrier and
  1188.          returning to the command state.  When Robocomm attempts to hang
  1189.          up your phone, it will first try to "Drop DTR."  This is the
  1190.          fastest and most reliable way of hanging up.  If your modem
  1191.          supports the Hayes "&" extended command set, adding "&D2" to your
  1192.          initialization string will solve the problem.
  1193.  
  1194.          HAYES 2400 COMPATIBLE SUGGESTED INITIALIZATION STRING - To solve
  1195.          CD and DTR problems, the following initialization string is
  1196.          recommended for all modems which are compatible with the Hayes
  1197.          2400:
  1198.  
  1199.               ATZ!~~~~AT E1 V1 Q0 X4 M0 &C1 &D2!
  1200.  
  1201.          HAYES 1200 COMPATIBLE SUGGESTED INITIALIZATION STRING - In the
  1202.          case of most 1200 baud modems, proper reporting of CD & DTR
  1203.          requires the setting of a DIP switch. For the Hayes 1200
  1204.          external, switch 6 must be in the "Up" position (The switches are
  1205.          located behind the face plate on Hayes 1200 modems). Note that
  1206.          "Up" is not the factory setting for switch 6. For the Hayes 1200
  1207.          internal, switch 3 is used to control the status of CD & DTR
  1208.          settings.  If, after you try Robocomm the first time it wasn't
  1209.          able to hang up, throw switch 3 in the other direction and try
  1210.          again.
  1211.  
  1212.          The recommended initialization string for Hayes 1200 compatible
  1213.          modems is also the Robocomm default initialization string:
  1214.  
  1215.               ATZ!~~~~AT E1 V1 Q0 X4 M0!
  1216.  
  1217.     MODEM DIAL COMMAND - Enter the command which needs to be sent to your
  1218.     modem to initiate a dial.  The default ATDT is the Hayes standard
  1219.     command and will work in the vast majority of instances. If your phone
  1220.     ______________________________________________________________________
  1221.     Robocomm 4.0 User's Guide                                      Page 17
  1222.  
  1223.  
  1224.  
  1225.  
  1226.     connection does not support touch tone dialing, specify ATDP in this
  1227.     setting to use pulse dialing.  PBX users who require access to an
  1228.     outside line before dialing may want to add the number to access the
  1229.     outside line followed by one or more commas. Each comma causes a pause
  1230.     of the number of seconds specified in your modem's "S8" register.  Set
  1231.     it with a ATS8=XX command, where XX is the number of seconds you want
  1232.     to pause per comma.  For example, "ATDT9,," would cause Robocomm to
  1233.     dial "9" and wait 1 second before sending the BBS phone number.
  1234.  
  1235.  
  1236.  
  1237.  
  1238.          NOTE:     You can create customized dialing commands on a BBS by
  1239.                    BBS basis through the use of Robocomm's "Dialing
  1240.                    Macros" feature.  See the section on setting up dialing
  1241.                    macros later in this configuration section.
  1242.  
  1243.  
  1244.  
  1245.  
  1246.     HANG UP STRING - Enter the string which Robocomm will send to the
  1247.     modem to attempt to hang up in the event "Dropping DTR" doesn't work.
  1248.     Use "~" for a half second pause and "!" to send a carriage return.
  1249.     The default hang-up string is:
  1250.  
  1251.          ~~~+++~~~ATH0!
  1252.  
  1253.     USE MODEM ON COM PORT # - Enter a number between 1 and 4 to indicate
  1254.     the COM port that Robocomm should use for communications. If you enter
  1255.     a number above 2, Robocomm will require you to define the start
  1256.     address and IRQ line to use when communicating with this port.
  1257.  
  1258.          START ADDRESS - Enter the address, in hexadecimal, of the COM
  1259.          port.
  1260.  
  1261.          IRQ - Enter the number of the IRQ line to use for this
  1262.          communications port.
  1263.  
  1264.     USE RTS/CTS FLOW CONTROL - Also know as "hardware" flow control, the
  1265.     use of this option allows Robocomm to inform the modem when it's
  1266.     internal communications buffer is about to overflow.  This enables
  1267.     both modems to stop sending information so your computer can catch up.
  1268.     If you are using Robocomm with a high speed modem, the use of RTS/CTS
  1269.     flow control is essential to guard against the potential loss of data
  1270.     if Robocomm's internal buffers fill up.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.          NOTE:     XON/XOFF flow control is automatically enabled at
  1276.  
  1277.  
  1278.     ______________________________________________________________________
  1279.     Robocomm 4.0 User's Guide                                      Page 18
  1280.  
  1281.  
  1282.  
  1283.  
  1284.                    communications rates of 2400 and lower.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.     MAXIMUM DIAL ATTEMPTS PER SYSTEM - Enter a number indicating the
  1290.     maximum number of dial attempts Robocomm should make for each BBS when
  1291.     attempting to connect.  This option applies only to dialing controlled
  1292.     by an agenda.  The Demon Dialer in terminal mode does not honor this
  1293.     setting.
  1294.  
  1295.  
  1296.  
  1297.  
  1298.          NOTE:     This option can be overridden for the current session
  1299.                    only with the /Ln command line switch, where n is the
  1300.                    number of redial attempts that should be made per
  1301.                    system in the agenda,
  1302.  
  1303.  
  1304.  
  1305.  
  1306.     DIAL ATTEMPTS BEFORE CYCLING - Enter the number of dial attempts that
  1307.     Robocomm should make to connect with a system before cycling to the
  1308.     next BBS in the redial queue.  When Robocomm reaches the end of the
  1309.     queue, it will return to the first number in the queue and begin
  1310.     dialing the systems again, until a connection is made or the maximum
  1311.     redial attempts number is reached.
  1312.  
  1313.     SECONDS BETWEEN DIAL ATTEMPTS - Enter the maximum number of seconds
  1314.     that should elapse between the start of two consecutive dialing
  1315.     attempts.  Unless a message indicating a connection is received from
  1316.     the modem, Robocomm will ensure that the number of seconds you specify
  1317.     here elapses before initiating the next dial attempt.  Fill in this
  1318.     option by completing the statement: "During agenda processing, I want
  1319.     Robocomm to dial a phone number every _____ seconds. "
  1320.  
  1321.     Entering a zero in this field will cause Robocomm to redial as rapidly
  1322.     as possible by initiating a new dial as soon as any message is
  1323.     received back from the modem.
  1324.  
  1325.  
  1326.  
  1327.  
  1328.          NOTE:     Your modem most likely supports a command similar to
  1329.                    Robocomm's dialing delay with its S7 register. If you
  1330.                    find that your modem is returning "NO CARRIER" to
  1331.                    Robocomm before the number of seconds you specify here
  1332.                    has elapsed, add a "S7=n" command to your
  1333.                    initialization string, where n is the number of seconds
  1334.                    you specify in the Robocomm configuration option.
  1335.  
  1336.     ______________________________________________________________________
  1337.     Robocomm 4.0 User's Guide                                      Page 19
  1338.  
  1339.  
  1340.  
  1341.  
  1342.                    Consult your modem manual for more details.
  1343.  
  1344.  
  1345.  
  1346.  
  1347.     DELAY AFTER MODEM RESPONSE - Some modems send more than one line of
  1348.     information when they are unable to connect. Some others require a
  1349.     little rest period after a failed dialing attempt before re-dialing.
  1350.     If your modem fits either of these categories, you should enter a
  1351.     number in this field.  If you do, Robocomm will wait the number of
  1352.     seconds you specify after a modem response is received, discarding any
  1353.     characters received during that time period.
  1354.  
  1355.     BREAK BEFORE INITIALIZING - If your modem or network setup requires a
  1356.     BREAK signal to "wake up" the modem before sending the initialization
  1357.     string, set this option to YES.  The default for this option is NO.
  1358.  
  1359.     IGNORE MODEM CD STATUS - If you get an error message from Robocomm
  1360.     whenever it attempts to hang up the phone and you are unable to get
  1361.     your modem to properly report CD (Carrier Detect) status, set this
  1362.     option to "YES" and Robocomm will bypass all attempts to determine if
  1363.     your modem is on or off hook.
  1364.  
  1365.  
  1366.  
  1367.  
  1368.          NOTE:     With this option set to "YES" Robocomm will be unable
  1369.                    to sense if the connection between it and the BBS is
  1370.                    unexpectedly interrupted.  This may result in delays in
  1371.                    processing.  So, make sure you've included &C1&D2 in
  1372.                    your initialization string, and try a new modem cable
  1373.                    before giving up and setting up Robocomm to ignore CD
  1374.                    status.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.     INACTIVITY TIMEOUT (SECONDS) - If the BBS system you are calling
  1380.     hangs, or excessive line noise causes Robocomm to be confused,
  1381.     Robocomm will wait the number of seconds you specify here for a line
  1382.     of text from the BBS.  If a complete line of text, ending with a
  1383.     carriage return, is not received within the number of seconds
  1384.     specified here, Robocomm will hang up immediately and continue with
  1385.     the next BBS on the agenda.  The number of seconds since the last
  1386.     received line of text is displayed in the upper right corner of the
  1387.     screen while Robocomm is on-line.
  1388.  
  1389.     AGENDA ITEM TIMEOUT (MINUTES) -  Enter the maximum number of minutes
  1390.     that any one agenda item should take to complete.  This is a safety
  1391.     hatch against a runaway "looping" situation which might occur if your
  1392.     prompt definitions don't properly match those sent by the BBS or if a
  1393.     script file is designed improperly.  Set this option to a value that
  1394.     ______________________________________________________________________
  1395.     Robocomm 4.0 User's Guide                                      Page 20
  1396.  
  1397.  
  1398.  
  1399.  
  1400.     makes you feel comfortable, but be careful not to set it too low.
  1401.     Some file and mail scan operations can take quite a while to complete.
  1402.  
  1403.  
  1404.  
  1405.  
  1406.          NOTE:     File transfers stop the clock on this timeout watch.
  1407.                    You don't need to worry about Robocomm disconnecting
  1408.                    during a file transfer because this timeout value has
  1409.                    been reached.
  1410.  
  1411.  
  1412.  
  1413.  
  1414.     NUMBER OF FAILED CALLS TO ALLOW - Set this option by answering the
  1415.     question: "I only want Robocomm to dial a system ____ times if the
  1416.     system is not responding properly."   This option allows you to avoid
  1417.     long dialing periods when BBS systems go "down" unexpectedly.
  1418.  
  1419.     Whenever Robocomm dials a phone number and no response or NO CARRIER
  1420.     is received back from the modem within the number of seconds specified
  1421.     in your Seconds Between Dialing Attempts option, an internal count of
  1422.     "Failed Calls." for that system is incremented.  If the cumulative
  1423.     number of failed calls encountered for a BBS during a single agenda
  1424.     run equals the number you input for this option, Robocomm will
  1425.     automatically remove the BBS from the dialing queue.
  1426.  
  1427.     Failed call detection is also designed to minimize the danger of
  1428.     dialing long distances in unattended mode.  If the modem on the other
  1429.     end of a Robocomm call is malfunctioning and answers the phone but no
  1430.     connection is established, Robocomm has no way of knowing that and
  1431.     could redial the system up to the number of times specified in the
  1432.     Dial Attempts Per System option.  This option minimizes the ill
  1433.     effects of such a situation.  You should set it at whatever level
  1434.     makes you most comfortable.
  1435.  
  1436.     KEEP BBS FILE'S TIME STAMP - If you are downloading with Robocomm's
  1437.     internal Zmodem protocol, and would like the time and date of
  1438.     downloaded files to be the same as those on the BBS system, set this
  1439.     option to YES.  If you would prefer Robocomm to set the time and date
  1440.     stamps to the current time and date at the end of the download, set
  1441.     this option to NO.
  1442.  
  1443.  
  1444.  
  1445.  
  1446.          NOTE:     System operators downloading files for their BBS will
  1447.                    almost certainly want to set this option to NO.  Doing
  1448.                    so will ensure that Robocomm downloaded files show up
  1449.  
  1450.  
  1451.  
  1452.     ______________________________________________________________________
  1453.     Robocomm 4.0 User's Guide                                      Page 21
  1454.  
  1455.  
  1456.  
  1457.  
  1458.                    properly during their caller's new file scans.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.     ALLOW CONNECTS AT LOWER SPEED - If you have a high speed modem and
  1464.     would prefer not to accidentally connect with systems operating at
  1465.     2400 baud or below, set this option to NO.  If you do this, Robocomm
  1466.     will immediately hang up the line, remove the BBS from the agenda
  1467.     dialing queue and make a note in the log if it dials out at 9600 bps
  1468.     or above and connects at below 9600 bps.  This option is designed to
  1469.     keep phone bills down if you plan a to move a significant number of
  1470.     bytes and don't want Robocomm to do it if the modem (for whatever
  1471.     reason) accidentally establishes a connection at a lower rate than
  1472.     expected.
  1473.  
  1474.     EXPLODING WINDOWS - By default, Robocomm's data display windows
  1475.     "explode" on the screen.  If you would like to disable this feature or
  1476.     change the speed at which the windows explode, use this option. The
  1477.     fastest window speed setting is 1, and the slowest is 1000.
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.     ______________________________________________________________________
  1511.     Robocomm 4.0 User's Guide                                      Page 22
  1512.  
  1513.  
  1514.  
  1515.  
  1516.        Utility Configuration
  1517.  
  1518.     To specify the utility programs that Robocomm will use while
  1519.     operating, select Configure from the main menu, followed by Utilities.
  1520.     You will be presented with the following screen:
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.     FILE LIST/BROWSE COMMAND - Robocomm allows you to view its log and
  1538.     capture files with its internal file viewing utility if you specify
  1539.     the word INTERNAL here.  While the internal view is quite fast and
  1540.     easy to use, it lacks the ability to do text searches.  You might
  1541.     prefer to use Vernon D. Buerg's excellent LIST.COM utility for file
  1542.     browsing.  However, you may also want to use SemWare's QEdit to browse
  1543.     your log and capture files, as this super-fast editor will allow you
  1544.     to also edit and print the file as you browse.  Whichever you choose,
  1545.     just enter the name of the command needed to run the utility here.
  1546.     Robocomm will supply the appropriate file name as a parameter at run-
  1547.     time.
  1548.  
  1549.     .ZIP & ALTERNATE EXTRACTION COMMANDS - Those of you who are already
  1550.     familiar with bulletin boards are undoubtedly also accustomed to using
  1551.     file compression & decompression utilities.  Robocomm requires access
  1552.     to a decompression utility to extract the NEWFILES.DAT file from the
  1553.     mail packets that it downloads from QWK format mail doors.  Robocomm
  1554.     will automatically detect if your .QWK packet was created with ZIP
  1555.     format, and call the appropriate extraction utility.  If the mail
  1556.     packet was not created with the ZIP format, Robocomm will run the
  1557.     alternative extraction utility that you specify in the Alternate
  1558.     Extraction Command field.  In either case, the extraction utility will
  1559.     be called with 2 parameters, as follows:
  1560.  
  1561.        <Decompression utility name> <Mail packet name> NEWFILES.DAT
  1562.  
  1563.     VIEW COMPRESSED FILE COMMAND - The command you specify here will be
  1564.     executed whenever you execute the View command in the directory of
  1565.     downloaded files or when you select a compressed PCBMail packet for
  1566.     reading. Robocomm defaults to SHEZ, the excellent Shareware
  1567.     "Compression Companion" by Jim Derr.  SHEZ will allow you to quickly
  1568.     ______________________________________________________________________
  1569.     Robocomm 4.0 User's Guide                                      Page 23
  1570.  
  1571.  
  1572.  
  1573.  
  1574.     view, extract, test, convert or alter the contents of virtually any
  1575.     compressed file you may have downloaded.
  1576.  
  1577.     VIEW GIF IMAGE FILE COMMAND - If the highlighted file name is a GIF
  1578.     image file, Robocomm will call the utility you enter in this field to
  1579.     view the file.  The file name will be passed as the sole command line
  1580.     parameter to the utility.
  1581.  
  1582.     DEFAULT FILE TRANSFER PROTOCOLS - Each system definition in Robocomm's
  1583.     BBS directory includes fields to set the transfer protocol for four
  1584.     different file transfer situations:
  1585.  
  1586.          *  Mail Upload
  1587.          *  Mail Download
  1588.          *  File Upload
  1589.          *  File Download
  1590.  
  1591.     The four corresponding options on the Utility Configuration screen
  1592.     allow you to set the default values that Robocomm will insert in any
  1593.     new BBS system definition you create.  Robocomm includes 3 internal
  1594.     protocols, which can be specified with the following key words:
  1595.  
  1596.          ZMODEM - The standard protocol for high speed, reliable file
  1597.          transfers.  Most BBS systems offer Zmodem as a file transfer
  1598.          protocol.  You should use this protocol if it is available.
  1599.  
  1600.          YMODEM - This older, batch protocol is offered on all PCBoard BBS
  1601.          systems.  If all else fails, you should always be able to use
  1602.          this protocol.
  1603.  
  1604.  
  1605.  
  1606.  
  1607.          NOTE:     Robocomm 4.0's implementation differs from that used in
  1608.                    Robocomm 2.0.  If you were using Robocomm 2.0 for
  1609.                    YMODEM transfers, you should make sure that you select
  1610.                    Ymodem as your transfer protocol on the BBS, not
  1611.                    Xmodem-1K, as was required by Robocomm 2.0.
  1612.  
  1613.  
  1614.  
  1615.  
  1616.          YMODEM-G - An ultra-fast transfer protocol that relies on the
  1617.          built in error correcting capabilities of modems with MNP
  1618.          capability.  If you have a high speed modem with a fast computer
  1619.          and a 16550 UART installed, you might want to use this protocol
  1620.          instead of Zmodem.
  1621.  
  1622.          Using External Protocols -  The Robocomm distribution files
  1623.          contain several ROBOS?.BAT (Send) and ROBOR?.BAT (Receive) sample
  1624.          batch files which implement protocol transfers with two popular
  1625.          external protocol engines, DSZ  and HS/Link.  To use one of these
  1626.     ______________________________________________________________________
  1627.     Robocomm 4.0 User's Guide                                      Page 24
  1628.  
  1629.  
  1630.  
  1631.  
  1632.          batch files, make sure the appropriate transfer engine utility is
  1633.          available in your DOS PATH setting, and specify the appropriate
  1634.          batch file name in the spaces provided.  For example, to use
  1635.          Zmodem-MobyTurbo for your file transfers, specify ROBORZ (For
  1636.          Robo receive Zmodem) and ROBOSZ for (Robo send Zmodem) and make
  1637.          sure that DSZ.COM or DSZ.EXE is in your current DOS search PATH.
  1638.  
  1639.  
  1640.  
  1641.  
  1642.          NOTE:     Robocomm uses the DOS ERRORLEVEL returned from the file
  1643.                    transfer program to detect unsuccessful file transfers.
  1644.                    If you decide to use a file transfer utility other than
  1645.                    DSZ or HS/Link, make sure it returns an ERRORLEVEL of 1
  1646.                    or greater in the event of an unsuccessful file
  1647.                    transfer.
  1648.  
  1649.  
  1650.  
  1651.  
  1652.     CREATING OR MODIFYING YOUR OWN FILE TRANSFER BATCH FILES - Advanced
  1653.     users may want to modify the default external protocol batch files or
  1654.     even create their own.  To do so, just specify the name of the
  1655.     appropriate batch file to call in each of the 4 file transfer
  1656.     situations.  When Robocomm calls one of these batch files to start a
  1657.     transfer, it will pass up to four parameters:
  1658.  
  1659.  
  1660.        Parameter         Uploads (Send)          Downloads (Receive)
  1661.  
  1662.            %1       Comm port in use         Comm port in use
  1663.  
  1664.            %2       Current communications   Current communications
  1665.                     rate                     rate
  1666.  
  1667.            %3       Full path and name of    File being received (not
  1668.                     file being sent          used by most batch
  1669.                                              transfer protocols)
  1670.  
  1671.            %4                 N/A            Directory to receive
  1672.                                              downloaded files
  1673.  
  1674.  
  1675.      For example, the ROBOSZ.BAT file contains just one line, calling DSZ
  1676.     to start the transfer as follows:
  1677.  
  1678.          DSZ port %1 speed %2 sz -m %3
  1679.  
  1680.     When DSZ is called, parameter %1 is replaced by the current comm port,
  1681.     parameter %2 is replaced by the current speed of the connection
  1682.     between the computer and the modem (not necessarily the same as the
  1683.     connection speed between the two modems), and parameter %3 is replaced
  1684.     ______________________________________________________________________
  1685.     Robocomm 4.0 User's Guide                                      Page 25
  1686.  
  1687.  
  1688.  
  1689.  
  1690.     by the FULL PATH and FILE NAME of the file being transferred.  The
  1691.     ROBORH.BAT (HS/Link receive) uses the fourth parameter (sent only on
  1692.     downloads) which contains the target directory for received files:
  1693.  
  1694.          HSLINK -P%1 -B%2 -! -HS -U%4
  1695.  
  1696.  
  1697.  
  1698.  
  1699.          NOTE:     An external protocol batch file called GIFDOWN.BAT is
  1700.                    included with the Robocomm distribution files.  It uses
  1701.                    the popular Shareware utility SHOWGIF to display GIF
  1702.                    files as they are being downloaded with DSZ Zmodem.
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.     COMMAND TO INVOKE MAIL READER - Robocomm allows you to run your mail
  1709.     reader from its main menu.  To do so, just enter the command that
  1710.     Robocomm should use to start your mail reader in this field. With most
  1711.     mail readers, you can set an environment variable to tell the reader
  1712.     program where to find its support files.  In other instances, you will
  1713.     want to create a short batch file that switches to the appropriate
  1714.     subdirectory before calling your mail reader. A simpler alternative
  1715.     may be to install your mail reader into your Robocomm subdirectory, or
  1716.     to copy your reader's configuration file into the Robocomm
  1717.     subdirectory. If you do this, you can specify your reader directly,
  1718.     without the need for a batch file.  Robocomm automatically restores
  1719.     the proper working directory once you quit your mail reader.
  1720.  
  1721.     RAM FOR FILE TRANSFER AND EXTRACT - Enter the kilobytes of memory
  1722.     required by your file transfer and file extraction utilities.
  1723.     Robocomm allows you to specify this value so that it will not have to
  1724.     swap all of itself out of memory every time it downloads or extracts a
  1725.     file.  This saves time if your are low on EMS or XMS memory and
  1726.     Robocomm is forced to swap to disk.  If you are using an alternative
  1727.     command processor, such as NDOS or 4DOS and receive error messages
  1728.     when Robocomm attempts to run outside utilities, you should increase
  1729.     this configuration option.
  1730.  
  1731.  
  1732.     RAM NEEDED FOR READER AND DOS - Enter the amount of memory that
  1733.     Robocomm should free up whenever it shells to DOS or runs your mail
  1734.     reader.  By default, Robocomm sets this value to zero, which means it
  1735.     will attempt to free up as much RAM as possible.  If you specify a
  1736.     number here which is greater than the amount of RAM it is possible to
  1737.     free up, Robocomm will free as much as possible.  Remember that your
  1738.     mail reader may also need to shell out to DOS to run file extraction
  1739.     and compression programs, so make sure to allow enough RAM for that
  1740.     process as well.
  1741.  
  1742.     ______________________________________________________________________
  1743.     Robocomm 4.0 User's Guide                                      Page 26
  1744.  
  1745.  
  1746.  
  1747.  
  1748.        Data and Log Configuration
  1749.  
  1750.     To access the configuration screen controlling the location and names
  1751.     of files used by Robocomm, select Configure from the main menu,
  1752.     followed by Data & Logs.  You will be presented with the following
  1753.     screen:
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.     PATH FOR MAIL PACKETS (*.QWK, *.PCB) - Enter the drive and directory
  1772.     where you want Robocomm to place incoming mail packets. This should
  1773.     normally be the same directory that you specify in your mail reader
  1774.     configuration.
  1775.  
  1776.     PATH FOR REPLY PACKETS (*.REP) - Enter the drive and directory that
  1777.     Robocomm should look in to find reply packets that are waiting to be
  1778.     sent.  This should be the same directory that you specify in your mail
  1779.     reader's configuration.
  1780.  
  1781.     FILE RENUMBERING STYLE  - Robocomm can place the number indicating the
  1782.     age of an archived file at the beginning or end of the file name.  Use
  1783.     this option to toggle between the two options, ????????.??and
  1784.     9???????.???.
  1785.  
  1786.  
  1787.  
  1788.  
  1789.          NOTE:     Some mail readers will mistakenly attempt to re-process
  1790.                    a REP packet that has been archived renamed with the
  1791.                    ????????.??9 style.  If that's the case with your
  1792.                    reader, you should choose the alternate style, with the
  1793.                    archive number at the beginning of the file.
  1794.  
  1795.  
  1796.  
  1797.  
  1798.     NUMBER OF OLD .QWK FILES TO ARCHIVE- Robocomm will rename and keep up
  1799.     to 9 old QWK and PCB mail packets on hand for you.  Depending on your
  1800.     ______________________________________________________________________
  1801.     Robocomm 4.0 User's Guide                                      Page 27
  1802.  
  1803.  
  1804.  
  1805.  
  1806.     configuration, Robocomm will add the numbers 1 through 9 to the
  1807.     beginning or end of the file name. 1 is the newest "old" packet and 9
  1808.     would be the oldest.  You can specify the maximum number of old
  1809.     packets to keep for each BBS by changing this number.  Enter 0 to keep
  1810.     no old packets.
  1811.  
  1812.     NUMBER OF OLD .REP FILES TO ARCHIVE  - This option works exactly like
  1813.     the QWK archiving described above.  Enter the number of REP packets
  1814.     that you would like Robocomm to keep on hand for you.
  1815.  
  1816.     FILE DOWNLOAD PATH - Robocomm will place all files (not mail packets)
  1817.     that it downloads in the directory you specify here.
  1818.  
  1819.     FILE UPLOAD PATH - Robocomm will use this directory as the default
  1820.     when prompting for files to upload while creating an agenda.  You can,
  1821.     however, upload files form any drive and directory on your system.
  1822.     This is only a default value.
  1823.  
  1824.  
  1825.  
  1826.  
  1827.          NOTE:     When creating agenda items, Robocomm will search any
  1828.                    number of specified directories for files to be upload.
  1829.                    See the discussion of Search Directories, later in the
  1830.                    configuration section, for details.
  1831.  
  1832.  
  1833.  
  1834.  
  1835.     NAME AND PATH FOR LOG FILE - Robocomm can keep a comprehensive log
  1836.     file of all of its on-line activity.  The log file will be created
  1837.     according to the file name and path you enter here.  If you do not
  1838.     wish to create a log file, leave this field blank.
  1839.  
  1840.     LOG FILE CREATION MODE - Pressing [Enter] with this field highlighted
  1841.     toggles the log file between APPEND and OVERWRITE modes.  In append
  1842.     mode, the log file is appended to each time you run an agenda.  In
  1843.     overwrite mode, the log file contains only the results of the most
  1844.     recently run agenda.
  1845.  
  1846.     LOG FILE TYPE - Robocomm create three different types of log files. By
  1847.     highlighting this option and pressing [Enter] you can toggle this
  1848.     setting between the following options:
  1849.  
  1850.          BRIEF       The smallest type of log file possible -
  1851.                      just connect/disconnect messages and 1 entry
  1852.                      to report the result of each agenda item.
  1853.  
  1854.          STANDARD    The log will be updated with useful
  1855.                      information and status messages throughout
  1856.                      the agenda.
  1857.  
  1858.     ______________________________________________________________________
  1859.     Robocomm 4.0 User's Guide                                      Page 28
  1860.  
  1861.  
  1862.  
  1863.  
  1864.          VERBOSE     The on-screen log will contain the same
  1865.                      information as the standard log, but the
  1866.                      disk file log will also contain a capture of
  1867.                      all text which was sent to or received from
  1868.                      the BBS system.  This type of log is useful
  1869.                      when you need to be absolutely certain that
  1870.                      the agenda went as intended, or when
  1871.                      diagnosing problems relating to customized
  1872.                      prompts.
  1873.  
  1874.  
  1875.  
  1876.     LOG FILE WINDOW SIZE -While Robocomm is on-line, the main screen is
  1877.     divided into two windows.  The top displays the on-line activity while
  1878.     the bottom lists all notations that are being made in the log file.
  1879.     This configuration item sets the number of screen rows that will be
  1880.     dedicated to displaying log data.
  1881.  
  1882.     DISK FOR TEMPORARY FILES - Whenever Robocomm needs to run an outside
  1883.     utility program or when you decide to shell to DOS, there is a chance
  1884.     that a temporary file will need to be made on your disk.  This file
  1885.     contains an image of the memory currently in use by Robocomm and will
  1886.     be created if there is insufficient EMS or XMS memory available.  To
  1887.     be safe, you should make sure that there is always at least 640K of
  1888.     free disk space available on the drive you specify here before you
  1889.     start Robocomm.  The F2 pop-up status window on the main menu screen
  1890.     always shows the amount of available temporary file space.  The
  1891.     display will flash if Robocomm detects that disk space is running low.
  1892.  
  1893.     Even if you plan to use memory for swapping, Robocomm still requires
  1894.     that you specify a valid swap drive here.  When the time comes to swap
  1895.     part of Robocomm out of main RAM, Robocomm will automatically use EMS
  1896.     or XMS if it is available.  If sufficient free EMS is NOT available,
  1897.     Robocomm will revert to using your specified swap disk drive.
  1898.  
  1899.  
  1900.  
  1901.  
  1902.          NOTE:     This setting is different than the SWAPPATH option in
  1903.                    the ROBO environment variable.  That option controls
  1904.                    the location of Robocomm's VM (Virtual memory) swap
  1905.                    files.  If you have a choice between two drives, you
  1906.                    should make sure that the SWAPPATH option points to the
  1907.                    faster of the two drives.
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.     OFFLINE FILES DRIVE - Use this option to specify the disk drive that
  1914.     Robocomm will move files to and from when you execute the
  1915.     "O"ffline/"O"nline command from the Downloaded Files directory.
  1916.     ______________________________________________________________________
  1917.     Robocomm 4.0 User's Guide                                      Page 29
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.     PCBOARD FILE LISTING TO UPDATE - Robocomm has the ability to write the
  1924.     file name, size, date and description of all the files it downloads to
  1925.     a standard PCBoard format file directory listing.  The listing will
  1926.     look just like the "New File" listings you see when scanning for new
  1927.     files on PCBoard.  Sysops can use this feature to automatically post
  1928.     files downloaded by Robocomm during their nightly event to their
  1929.     Uploads file directory DIR file!  Don't forget that with Robocomm's
  1930.     FIXFILE.BAT file, downloaded files can be prepared for posting in any
  1931.     way you like -- scan for viruses, insert custom ZIP comments, etc.
  1932.  
  1933.     WILDCAT FILE LISTING TO UPDATE - This option specifies the name of a
  1934.     text file to update for use in inserting files downloaded with
  1935.     Robocomm into Wildcat's data files.  The format of the file is:
  1936.  
  1937.        * One line per file, terminated with a carriage return+line-feed
  1938.          pair.
  1939.        * Each line contains the filename, padded to 12 spaces, followed by
  1940.          to blank spaces, followed by the file description.
  1941.  
  1942.  
  1943.        General Configuration Options
  1944.  
  1945.     Odds and ends that really didn't make sense on the other configuration
  1946.     screens are grouped together under the General banner.  To access the
  1947.     screen, select General from the Configure menu.
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.     YOUR BIRTH DATE - Your birth date: When logging on to Wildcat systems,
  1961.     Robocomm may be asked for your birth date. Enter it here, with no
  1962.     formatting characters between the months, days and years. For example,
  1963.     October 19th, 1962 would be entered as 101962
  1964.  
  1965.  
  1966.  
  1967.  
  1968.          NOTE:     The format may be different depending upon your
  1969.                    country's date format style.  Enter the date as the BBS
  1970.                    systems you call expect to receive it.
  1971.  
  1972.  
  1973.  
  1974.     ______________________________________________________________________
  1975.     Robocomm 4.0 User's Guide                                      Page 30
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.     YOUR PHONE NUMBER - Your phone number: Wildcat may also ask for your
  1982.     phone number when you are logging on.  Enter the
  1983.     number you input when setting up your user account
  1984.     on Wildcat systems.
  1985.  
  1986.     SPEAKER SOUND STYLE - Toggle this option between PUSHY, which turns
  1987.     all program sounds on, to SUBTLE which subdues the siren sounded on
  1988.     entering the terminal mode to SILENT which completely disables all
  1989.     sounds.
  1990.  
  1991.     EXPLODING WINDOWS - Toggle this option OFF and ON to control the way
  1992.     pop-up windows are displayed on screen.  This option also controls the
  1993.     "sliding screen" effect that is used when Robocomm runs outside
  1994.     programs.
  1995.  
  1996.     AVAILABLE FILES SORT - Use this option to toggle the sort key used
  1997.     when the Available Files Directory is sorted by Date.  Some users
  1998.     prefer the list sorted by the file date that was displayed on the BBS,
  1999.     while others prefer the list sorted by the date of the file scan.
  2000.  
  2001.     AVERAGE DOWNLOAD CPS - Enter the average characters per second your
  2002.     system achieves on a typical file download.  Robocomm will use this
  2003.     figure to make estimates about the download time of the entries in
  2004.     your Available Files directory..
  2005.  
  2006.     FTS INDEX DETAIL LEVEL - Enter a number between 1 and 3 to select the
  2007.     level of detail you want in your FTS Index files.  Robocomm uses the
  2008.     FTS files to quickly search the contents of its available and
  2009.     downloaded files directories.   Internally, Robocomm uses this option
  2010.     to determine the number of bytes-per-record that it can use for it FTS
  2011.     index files:
  2012.  
  2013.  
  2014.           Level  Bytes  Notes
  2015.  
  2016.             1      16   Provides the slowest searches, but consumes
  2017.                         the least amount of disk space.  If you are
  2018.                         running in a low memory situation and have
  2019.                         to set the Memory for FTS Buffers option to
  2020.                         a value below 8K, you should use this
  2021.                         option.
  2022.  
  2023.             2      32   Provides a good compromise value.  This is
  2024.                         the default value.
  2025.  
  2026.             3      64   Consumes the most disk space but also gives
  2027.                         extremely fast searches when combined with
  2028.                         a relatively large setting in the Memory
  2029.                         For FTS Index Buffers option.
  2030.  
  2031.  
  2032.     ______________________________________________________________________
  2033.     Robocomm 4.0 User's Guide                                      Page 31
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.     MEMORY FOR FTS INDEX BUFFERS - Use this option to specify the amount
  2040.     of conventional memory in kilobytes (A kilobyte is 1024 bytes) that
  2041.     Robocomm will reserve for use by the high speed search routines.  If
  2042.     you find that you rarely use the Find option on either of the file
  2043.     directory menus or if the amount of Free Memory displayed in the F2
  2044.     pop-up status window is below 40K, then you should set this option
  2045.     down to a low value, such as 6.  The minimum allowable setting is 2.
  2046.  
  2047.     The key thing to keep in mind when setting this option is that any
  2048.     memory you specify for the FTS buffers will not be used by Robocomm
  2049.     for any other purpose.  If you are running low on memory, it's best to
  2050.     leave this option as low as possible and let Robocomm make better use
  2051.     of the precious conventional memory.
  2052.  
  2053.     LOAD ROBOCOMM'S VGA FONT - Robocomm comes supplied with a customized
  2054.     VGA font that it can load to enhance the effect of its screen
  2055.     displays.  If your system is equipped with a VGA monitor and you'd
  2056.     like to use this font, set this option to YES.  If you use a multi-
  2057.     tasking environment and Robocomm's VGA font adversely effects the on
  2058.     screen appearance of other running tasks, or if the VGA font doesn't
  2059.     appear to be working and some of Robocomm's screen displays appear
  2060.     garbled, set this option OFF.
  2061.  
  2062.     If you normally have a different VGA font loaded and you want Robocomm
  2063.     to re-load this font whenever it exits to DOS, follow the following
  2064.     procedure:
  2065.  
  2066.  
  2067.          1. Make sure that your screen is set in standard 80x25 mode.
  2068.  
  2069.          2. Load your customized VGA font and make sure it is active.
  2070.  
  2071.          3. Change into the Robocomm subdirectory.
  2072.  
  2073.          4. Type EXITFONT at the DOS prompt.
  2074.  
  2075.  
  2076.     This procedure will create an EXITFONT.VGA file in your Robocomm
  2077.     directory that contains an image of your preferred VGA font.  Robocomm
  2078.     will look for this file and use it to reset the character set whenever
  2079.     it exits to DOS.
  2080.  
  2081.        PC-Pursuit Configuration
  2082.  
  2083.     If you are a PC Pursuit user and plan to use Robocomm's built-in PC
  2084.     Pursuit dialing capabilities, you will need to fill in the information
  2085.     that appears on the PC Pursuit Configuration Settings screen:  To
  2086.     access this screen, Select PC Pursuit from the Configure menu.
  2087.  
  2088.  
  2089.  
  2090.     ______________________________________________________________________
  2091.     Robocomm 4.0 User's Guide                                      Page 32
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.     PC PURSUIT USER ID - Enter your PC Pursuit User ID in this field.
  2109.  
  2110.     PC PURSUIT PASSWORD - Enter your PC Pursuit password in this field.
  2111.     The password will be displayed as a series of asterisks when you view
  2112.     the screen, and the password will not be displayed during dialing
  2113.     operations.
  2114.  
  2115.     1200 & 2400 BAUD INDIAL NUMBERS - Use the two fields provided to enter
  2116.     the phone number of the PC Pursuit indials which are closest to you.
  2117.     Robocomm will use the 1200 or 2400 baud indial number depending upon
  2118.     the baud rate that you have set for the BBS on the Directory-BBS
  2119.     screen.  You can edit your configured dialing macros at any time while
  2120.     entering a phone number.  Just press F10 to access the pop-up Dialing
  2121.     Macros window.
  2122.  
  2123.     X.3 PAD PARAMETERS - This optional setting is intended for expert
  2124.     users who seek to maximize their throughput on PC Pursuit.  It is not
  2125.     needed for normal Robocomm operations.  Telenet has published a
  2126.     specification of settings which it considers optimal for Zmodem
  2127.     throughput on the network.
  2128.  
  2129.       IT IS CRUCIAL THAT YOU DO NOT USE THE "1" PARAMETER WITH ROBOCOMM.
  2130.  
  2131.     This parameter prohibits Robo from using the "@<CR>" sequence to
  2132.     escape from the outdial modem.  If you are feeling experimental, you
  2133.     might want to try placing "4:10,5:1,7:8,12:1" in this field.  Keep in
  2134.     mind though that if PC Pursuit file transfers are working fine for
  2135.     you, it's probably best not to tinker with it.
  2136.  
  2137.     USE PURSUIT DURING PRIME TIME - By default, Robocomm will not dial
  2138.     into PC Pursuit during it's "Prime Time" billing hours.  If your
  2139.     pocketbook permits, you can override this default with this setting.
  2140.     Use the "Begin dialing after" and "Do Not Dial After" options to
  2141.     define PC Pursuit's Prime Time hours.  Be sure to allow enough time
  2142.     for your agendas to finish before Prime Time starts.
  2143.  
  2144.     CURRENT MONTH'S CUMULATIVE USAGE - Robocomm keeps track of the amount
  2145.     of time it spends on PC Pursuit so you can keep an eye on the 30 hour
  2146.     usage limit.  Whenever Robocomm spends more than 119 consecutive
  2147.     seconds in an outdial city, it will increment the amount of time in
  2148.     ______________________________________________________________________
  2149.     Robocomm 4.0 User's Guide                                      Page 33
  2150.  
  2151.  
  2152.  
  2153.  
  2154.     it's internal counter.  If you use Pursuit from another comm program
  2155.     or though Robocomm's terminal mode, you will need to increment this
  2156.     number manually to keep it updated.
  2157.  
  2158.  
  2159.  
  2160.  
  2161.          NOTE:     Robocomm does not zero out the counter automatically
  2162.                    when a new month rolls around.  You will need to do
  2163.                    this yourself by editing the field to 0.
  2164.  
  2165.  
  2166.  
  2167.  
  2168.        Dialing Macros
  2169.  
  2170.     You may place the letters A-J anywhere within a phone number and
  2171.     Robocomm will replace the character with the corresponding string that
  2172.     you set up on the dialing macro table.  The dialing macro table can be
  2173.     viewed and edited by pressing  F10  while editing any phone number or
  2174.     by selecting Dialing Macros from the Configuration menu.
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.     For example, to disable call waiting, you might define dialing macro
  2191.     "C" as "*70" and input your phone numbers as:
  2192.  
  2193.          C1-312-752-1258
  2194.  
  2195.     CUSTOMIZED DIALING COMMANDS are made possible by prefixing any defined
  2196.     macro letter with a (backwards tick mark) character. Doing so causes
  2197.     the contents of the macro letter to be used to dial the number instead
  2198.     of the default dialing command specified on the Communications
  2199.     Configuration screen. This enables you to send customized commands to
  2200.     the modem on a BBS by BBS basis. For example, to turn on the modem
  2201.     speaker ON when dialing Group One BBS, you could input this as the
  2202.     phone number:
  2203.  
  2204.          `E1-312-752-1258
  2205.  
  2206.     ______________________________________________________________________
  2207.     Robocomm 4.0 User's Guide                                      Page 34
  2208.  
  2209.  
  2210.  
  2211.  
  2212.     Then you would set up the "E" dialing macro as:
  2213.  
  2214.          ATM1DT
  2215.  
  2216.     The most common use for this feature will probably be to turn off MNP
  2217.     negotiation if you are calling a system with a non-MNP modem from a
  2218.     MNP capable modem.  Doing this keeps the first prompt sent by the BBS
  2219.     from being eaten by your modem's attempts to negotiate an MNP connect.
  2220.     To do this, you might set up a dialing macro letter as AT&M0DT and
  2221.     then include the macro letter, along with a preceding ` character in
  2222.     the phone number.
  2223.  
  2224.  
  2225.  
  2226.  
  2227.          NOTE:     To send a break signal to the modem before every dial
  2228.                    attempt, set up a dialing macro as the word BREAK and
  2229.                    then include the letter in the phone number to be
  2230.                    dialed.
  2231.  
  2232.  
  2233.  
  2234.  
  2235.        Setting Up Display Colors
  2236.  
  2237.     To set the colors that are used on-screen while Robocomm is running,
  2238.     select Display Colors from the Configure menu.  Robocomm will present
  2239.     you with a screen listing all of the colors currently in use by the
  2240.     system.  Use this screen to control the colors Robocomm uses while in
  2241.     operation.  To do this, use the  +  and  -  keys to select the color
  2242.  
  2243.     that you would like to change indicated between the   and  characters
  2244.     on the screen and use the arrow keys to move the small box so that it
  2245.     surrounds the color that you would like to set.  When the desired
  2246.     color is selected, press [Enter] to confirm the color selection.
  2247.  
  2248.     On color systems, you can toggle between blinking foreground and high
  2249.     intensity backgrounds by pressing [Alt-B].  The effect of this is to
  2250.     give you 128 additional color selections. [Alt-D] will set the colors
  2251.     back to Robocomm's defaults for your monitor type, and [Alt-S] will
  2252.     save your color selections so they will be loaded each time you start
  2253.     Robocomm.
  2254.  
  2255.        Filter Words
  2256.  
  2257.     While importing file lists into your Available Files directory
  2258.     Robocomm will compare each potential new file entry against the
  2259.     contents of your Filter Words list to see if any of your Filter Words
  2260.     occur within the file name, BBS name and description.  If a match is
  2261.     found the file will be ignored and NOT added to your Available Files
  2262.     directory. You can edit this list by selecting Filter Words from the
  2263.     Configure menu or by pressing [Alt-F] while in either the Available
  2264.     ______________________________________________________________________
  2265.     Robocomm 4.0 User's Guide                                      Page 35
  2266.  
  2267.  
  2268.  
  2269.  
  2270.     Files or Downloaded Files directory.
  2271.  
  2272.     For example, if you have no interest in graphics files, you might
  2273.     include the following words in your filter list:
  2274.  
  2275.         *  .GIF
  2276.         *  GRAPHICS
  2277.         *  IMAGE
  2278.         *  .PCX
  2279.         *  .BMP
  2280.         *  CLIP ART
  2281.         *  CLIPART
  2282.  
  2283.     Notice that the final word filter word, CLIP ART is listed twice.
  2284.     This is done because Robocomm does a literal comparison of the file
  2285.     information against its defined filter words, one at a time.  BBS
  2286.     users are just as likely to use CLIPART (one word) in a description as
  2287.     they are to enter CLIP  ART (two words).  If you want to be absolutely
  2288.     certain to remove all instances of a file type you need to think in
  2289.     terms of the different ways the word might be included in file lists.
  2290.  
  2291.           WILDCARD FILE NAMES MAY NOT BE INCLUDED IN THE FILTER LIST!
  2292.  
  2293.     For example, including *.GIF will not eliminate files with a GIF
  2294.     extension from the file list.  However, entering .GIF (excluding the
  2295.     asterisk, but including the leading period) will remove all GIF files,
  2296.     since that text is guaranteed to exist within any GIF file name.
  2297.  
  2298.     Finally, you should keep in mind the fact that Filter Words take
  2299.     precedence over Preference Words (described in the next section).  A
  2300.     file description that contains both a Filter Word and a Preference
  2301.     Word will not appear in your Available Files directory.
  2302.  
  2303.  
  2304.  
  2305.  
  2306.          NOTE:     You can define up to 4095 filter words, but keep in
  2307.                    mind that Robocomm has to check the entire BBS name,
  2308.                    file name and file description against each defined
  2309.                    filter word individually.  Try to strike a balance
  2310.                    between the number of filter words you define and the
  2311.                    speed of execution when importing files.  As a
  2312.                    practical matter, the faster your machine is, the more
  2313.                    filter words you can define.
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.        Preference Words
  2320.  
  2321.     Defining preference words works similarly to defining filter words but
  2322.     ______________________________________________________________________
  2323.     Robocomm 4.0 User's Guide                                      Page 36
  2324.  
  2325.  
  2326.  
  2327.  
  2328.     they have the opposite effect on your Available Files directory.
  2329.     After a file has passed the filter word test, Robocomm proceeds to
  2330.     check if this is a file that you are particularly interested in.  You
  2331.     tell Robocomm your interests by selecting Preference Words from the
  2332.     Configure menu, or by pressing [Alt-P] while in either the Available
  2333.     Files or Downloaded Files directory.
  2334.  
  2335.     Any new file entry that contains one or more of your defined
  2336.     preference words in its file name or description will be automatically
  2337.     marked with KEEP status as it is added to the Available Files
  2338.     directory.  This means that the file cannot be removed from the list
  2339.     until you physically remove the KEEP flag.
  2340.  
  2341.     For a discussion of how Robocomm parses the items in the Preference
  2342.     Words list, see the preceding Filter Words section.  Although the
  2343.     effect is quite different, the text comparison methodology is exactly
  2344.     the same.
  2345.  
  2346.        Search Directories
  2347.  
  2348.     Whenever you use the  Delete , View or Test commands in the Downloaded
  2349.     Files directory or select a file for upload, Robocomm will search all
  2350.     of the directories listed in the search directories window for the
  2351.     file.  This capability is particularly useful for System Operators or
  2352.     anyone else who may move files between a variety of directories and
  2353.     would like to have easy access to them from within Robocomm.  As long
  2354.     as every directory that a downloaded file might be moved into is
  2355.     listed in the Search Directories list, Robocomm will never loose track
  2356.     of a file, even if another utility moves it without informing
  2357.     Robocomm.  To access the list, select the Search Directories option
  2358.     from the
  2359.  
  2360.  
  2361.  
  2362.  
  2363.          NOTE:     When Robocomm attempts to upload a file, it expects to
  2364.                    find the file in the same location as was specified
  2365.                    when the agenda item was created. The directories
  2366.                    listed in your Search Directories window will not be
  2367.                    searched while an agenda is in progress.
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.     ______________________________________________________________________
  2381.     Robocomm 4.0 User's Guide                                      Page 37
  2382.  
  2383.  
  2384.  
  2385.  
  2386.        MANAGING THE SYSTEMS DIRECTORY
  2387.  
  2388.        By selecting Directory followed by BBS Systems from the main
  2389.     Robocomm menu, you will placed in the Systems-Directory screen. This
  2390.     is where you edit or view all the information specific to the bulletin
  2391.     board systems you plan to call with Robocomm.
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.     The number of systems you can enter here is limited only by your
  2417.     available disk space.  The directory is automatically sorted by the
  2418.     BBS ID each time you add or edit a system.  The BBS Systems-Directory
  2419.     screen uses a dual light bar menu system. Use the up and down arrow
  2420.     keys to select the BBS system that you are interested in, then use
  2421.     left and right arrow keys or any of the highlighted speed keys to
  2422.     select the option to perform from the menu at the top of the screen.
  2423.  
  2424.  
  2425.        Adding Systems
  2426.  
  2427.        To add a new bulletin board system definition to Robocomm's
  2428.     database, choose Add from the top menu.  Robocomm will then prompt you
  2429.     to enter a unique "ID" for the system to add.  If the system you are
  2430.     adding supports a mail door, it is ESSENTIAL that the ID you enter
  2431.     here matches the BBS's mail ID exactly.  For instance, if you pick up
  2432.     a QWK mail packet JOEBLOW.QWK from "Joe Blow's Amazing BBS" you would
  2433.     enter "JOEBLOW" (no quotes!) at Robocomm's "System ID:" prompt.
  2434.  
  2435.     Following System ID assignment, Robocomm will prompt you to indicate
  2436.     the type of system being added and will display a message indicating
  2437.     the default prompt set that is being assigned.
  2438.     ______________________________________________________________________
  2439.     Robocomm 4.0 User's Guide                                      Page 38
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.     If you are adding a PCBoard system, it is quite likely that the
  2446.     "Default" prompt set will not be correct.  This is because there are
  2447.     many QWK format mail doors available for PCBoard systems.  Robocomm
  2448.     4.0's default PCBoard prompt definitions are set up for PCBoard 14.5
  2449.     systems running the Qmail 4.0 door, from Sparkware.  If the BBS you
  2450.     are adding does not use the Qmail 4.0 door you MUST assign the proper
  2451.     prompt definitions by editing the prompts manually or importing a pre-
  2452.     defined prompt definition file.  Robocomm supports the most popular
  2453.     QWK format doors with the following prompt definition files:
  2454.  
  2455.  
  2456.                Mail Door                         Prompt File
  2457.  
  2458.                Qmail 4.0                         DEFAULT.PPF
  2459.  
  2460.                CAM-Mail (all versions)           CAMMAIL.PPF
  2461.  
  2462.                MarkMail 2.0                      MARKMAIL.PPF
  2463.  
  2464.                RoseMail (all versions)           ROSEMAIL.PPF
  2465.  
  2466.  
  2467.     Setting Up ProDoor Systems - If you are setting up a system that is
  2468.     running the ProDoor Door and you would like to use the ProDoor for
  2469.     file scans and file transfers, you will need to import the PRODOOR.PPF
  2470.     prompt set.  If you are setting up a system that is ProDoor only,
  2471.     using ProLogon for access, you will need to import  the ALLPRO.PPF
  2472.     file.
  2473.  
  2474.     To import the appropriate prompt file for the system you are adding,
  2475.     select Prompts from the Directory-BBS menu, followed by Import.  Then,
  2476.     press F10 to get a list of the available prompt files.  After the
  2477.     prompts are imported, Robocomm will display any special instructions
  2478.     relevant to the particular BBS setup.  Please read them carefully!
  2479.  
  2480.  
  2481.        Editing Systems
  2482.  
  2483.        After entering a new system ID, or by highlighting the system to
  2484.     edit and selecting "Edit" from the Systems-Directory menu, you will be
  2485.     able to use the up and down arrow keys or the indicated speed key
  2486.     letters to select the specific information to change.  Press [Enter]
  2487.     when you have highlighted the field to change.
  2488.  
  2489.        SYSTEM NAME - Enter the full name of this BBS system.  This name
  2490.        will appear on Robocomm's screens and in log files.
  2491.  
  2492.        SYSTEM TYPE - Pressing [Enter] with this option highlighted will
  2493.        toggle between the following: possible options:
  2494.  
  2495.          *  PCBoard 14.2
  2496.     ______________________________________________________________________
  2497.     Robocomm 4.0 User's Guide                                      Page 39
  2498.  
  2499.  
  2500.  
  2501.  
  2502.          *  PCBoard 14.5
  2503.          *  Wildcat! 3.0 or 3.01
  2504.          *  Wildcat! 3.02 (or later)
  2505.          *  Login Script Only
  2506.  
  2507.  
  2508.  
  2509.  
  2510.          NOTE:     It is extremely important that you specify the correct
  2511.                    version of PCBoard or Wildcat.  There are subtle
  2512.                    differences in the required responses to the BBS's
  2513.                    prompts depending upon the version of the software
  2514.                    being run.  Both PCBoard and Wildcat BBS systems
  2515.                    display the software version number immediately after
  2516.                    connecting, before you even begin to log on.
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.        PHONE NUMBERS - Enter up to three phone numbers for the BBS in the
  2523.        spaces provided.  Enter the numbers  in order of connect
  2524.        preference.  Field #1 should contain the phone number you'd most
  2525.        like to connect with and #3 should be your last choice.  You may
  2526.        include one or more Dialing Macros in the phone numbers as well.
  2527.        See the discussion of Dialing Macros in the configuration section
  2528.        for further details.
  2529.  
  2530.  
  2531.  
  2532.  
  2533.          NOTE:     You may temporarily disable Robocomm's usage of an
  2534.                    individual phone number by placing a "/" character at
  2535.                    the beginning of the phone number field.
  2536.  
  2537.  
  2538.  
  2539.  
  2540.        LOGIN ID NAME - Enter your full name.  Robocomm will use this name
  2541.        when it logs on to the BBS.  Robocomm properly applies 3 part login
  2542.        IDs into BBS System's "First Name" and "Last Name" prompts.  Simply
  2543.        enter all 3 parts of your name in this field, separated by spaces,
  2544.        and Robocomm will do the rest.
  2545.  
  2546.        PASSWORD - Enter the password that Robocomm should use when logging
  2547.        on.
  2548.  
  2549.        BAUD RATE - Pressing [Enter] when this field is highlighted will
  2550.        toggle between the available baud rates for communications between
  2551.        Robocomm and your modem.  Robocomm will set communications to this
  2552.        baud rate before attempting to dial this system.  Robocomm always
  2553.        uses 8 data bits, no parity and 1 stop bit when communicating with
  2554.     ______________________________________________________________________
  2555.     Robocomm 4.0 User's Guide                                      Page 40
  2556.  
  2557.  
  2558.  
  2559.  
  2560.        PCBoard systems. The Default Baud Rate configuration option on the
  2561.        General configuration screen sets the baud rate which is used to
  2562.        initialize your modem at the start of an agenda.
  2563.  
  2564.  
  2565.  
  2566.  
  2567.          NOTE:     If you experience communications difficulties with the
  2568.                    baud rate set at 38400 baud, please select 19200 baud.
  2569.                    You should only use 38400 baud if you have a 16550 UART
  2570.                    and are certain that your system will be able to handle
  2571.                    that level of throughput reliably.
  2572.  
  2573.  
  2574.  
  2575.  
  2576.        MAIL DOOR MENU - (Wildcat Systems Only) - Select the menu that
  2577.        Robocomm must navigate to before issuing the command to open the
  2578.        mail door.
  2579.  
  2580.        MAIL DOOR COMMAND - (Wildcat Systems Only) - Enter the command that
  2581.        Robocomm must issue to open the mail door.  Use the pipe symbol "|"
  2582.        to represent carriage returns.
  2583.  
  2584.        FILE UPLOAD AREA - (Wildcat Systems Only) - Enter the BBS file area
  2585.        that Robocomm should upload files to.  If you enter a number here,
  2586.        Robocomm will always send files to this area, without asking you to
  2587.        enter a value when you are creating the upload agenda items.  If
  2588.        you enter the letter X, Robocomm will assume that the BBS does not
  2589.        ask you to assign an file area before the upload, and will not ask
  2590.        you to supply one.  If you leave this field blank, or enter the
  2591.        letter A, Robocomm will always ask for the upload area when
  2592.        creating upload agenda items for this BBS.
  2593.  
  2594.        PRODOOR NUMBER - (PCBoard Systems Only) - If the BBS has a ProDoor
  2595.        and you would like to have Robocomm use the ProDoor for file
  2596.        transfers and new file scans, enter the ProDoor door number in this
  2597.        field.  If Robocomm will have to join a conference before opening
  2598.        ProDoor, enter the conference number in the space provided. Use "0"
  2599.        if ProDoor is available from the main board.
  2600.  
  2601.        MAIL DOOR - (PCBoard Systems Only)  - If this BBS system has a QWK
  2602.        format mail door,  enter the number or name of the door to open in
  2603.        this field.  If Robocomm will need to join a conference before
  2604.        opening the mail door, specify the conference number or name in the
  2605.        space provided.
  2606.  
  2607.        ANSI GRAPHICS - (PCBoard Systems Only) - If you would like to see
  2608.        colors and/or ANSI graphics and animation on screen during agenda
  2609.        processing, set this option to YES.  This option also controls
  2610.        whether or not the QWK mail door will include colorized files in
  2611.        your mail packet.
  2612.     ______________________________________________________________________
  2613.     Robocomm 4.0 User's Guide                                      Page 41
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.        FILE CONFERENCE - Enter the name (PCBoard systems only) or number
  2620.        for the default "file" conference that you would like to send and
  2621.        receive files from on the BBS.
  2622.  
  2623.             * This conference will appear as the default when you create
  2624.               an "Upload File" agenda item.
  2625.  
  2626.             * This conference will appear as the default when you type in
  2627.               the name of a file to download without selecting it from the
  2628.               available files list.
  2629.  
  2630.             * This conference is used to fill in the Conference field when
  2631.               manually importing unmarked file lists into Robocomm's
  2632.               Available Files Directory.
  2633.  
  2634.             * If you use Robocomm's "Broadcast" mode to tag multiple BBS
  2635.               systems to upload to, Robocomm will make sure it is in this
  2636.               conference before sending the upload command to the BBS.
  2637.  
  2638.        PC PURSUIT CITY - If you want Robocomm to use PC Pursuit to connect
  2639.        with this BBS, enter the PC Pursuit outdial city for this BBS in
  2640.        this space.  If you use this option, make sure to remove the area
  2641.        code from the BBS phone numbers unless they are specifically
  2642.        required by the outdial modem  Also, make sure that you have
  2643.        properly filled out the PC Pursuit configuration screen.
  2644.  
  2645.        FILE TRANSFER PROTOCOLS - Robocomm allows you to individually
  2646.        specify different protocols to be used for file and mail transfers
  2647.        during agenda operations.  For each of the options, enter ZMODEM,
  2648.        YMODEM, YMODEM-G, or the name of an external protocol batch file.
  2649.        For detailed information on Robocomm's internal protocols and on
  2650.        setting up external protocols, see the Transfer Protocols topic in
  2651.        the Utilities Configuration section of this manual.
  2652.  
  2653.        LANGUAGE TO USE - Many PCBoard systems now offer the "Standard"
  2654.        prompts as a language option at logon.  This is a great benefit to
  2655.        Robocomm users because it saves you from having to create a
  2656.        customized prompt definition for the BBS. To specify the language
  2657.        containing standard prompts at logon, simply enter the number of
  2658.        the language that Robocomm should select here.
  2659.  
  2660.  
  2661.  
  2662.  
  2663.          NOTE:     If you are trying to call a BBS where the Sysop has
  2664.                    decided to customize the system's prompt files,
  2665.                    consider asking him/her to offer the "CDC Standard"
  2666.                    prompts as a language option.  It's a simple thing for
  2667.                    Sysops to set this up, and if you explain that being
  2668.                    "Robocomm friendly" will help more users access the BBS
  2669.  
  2670.     ______________________________________________________________________
  2671.     Robocomm 4.0 User's Guide                                      Page 42
  2672.  
  2673.  
  2674.  
  2675.  
  2676.                    in less time, they may be inclined to help you out!
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.        Deleting Systems
  2684.  
  2685.        To permanently remove a system from Robocomm's data files:
  2686.  
  2687.        1.Highlight the desired system ID in the scrolling list on the left
  2688.          side of the screen
  2689.        2.Select Delete from the menu, or press D.
  2690.        3.After deleting systems, you may want to go to the Available files
  2691.          directories and Bulk Erase any files which are marked as being
  2692.          available from the deleted BBS.
  2693.  
  2694.  
  2695.  
  2696.        Renaming Systems
  2697.  
  2698.        To change a system's assign ID:
  2699.  
  2700.        1.Highlight the desired system ID in the scrolling list on the left
  2701.          side of the screen
  2702.        2.Select Rename from the menu, or press R.
  2703.        3.Robocomm will prompt you for permission to change the system ID
  2704.          throughout the system.  If you confirm this, all your file and
  2705.          agenda entries which reference the old BBS ID will be updated to
  2706.          the new ID.
  2707.  
  2708.  
  2709.        Viewing System Statistics
  2710.  
  2711.     Once you have run your first agenda on a PCBoard system, you will
  2712.     notice that Robocomm issues a "V" command as its first action when it
  2713.     reaches the PCBoard menu prompt.  This displays your system
  2714.     statistics, such as your expiration date, your upload and download
  2715.     statistics, and also your conference selections.  Robocomm saves this
  2716.     data every time you log on, and you can view it at the Systems-
  2717.     Directory screen by highlighting a system ID and selecting the
  2718.     "STATISTICS" menu option.
  2719.  
  2720.  
  2721.  
  2722.        Editing System Notes
  2723.  
  2724.     Each BBS Directory System Definition includes an integrated notepad
  2725.     that you can use to store notes about the system setup or any other
  2726.     specific information you desire.  To access the notes highlight the
  2727.     desired BBS ID in the scrolling pick list, and then choose Notes from
  2728.     ______________________________________________________________________
  2729.     Robocomm 4.0 User's Guide                                      Page 43
  2730.  
  2731.  
  2732.  
  2733.  
  2734.     the top menu.  Press F1 while in the editor for help on specific
  2735.     notepad commands.  Press Ctrl+Enter when you've finish editing the
  2736.     notes and would like to save them to disk.
  2737.  
  2738.  
  2739.  
  2740.        Managing Prompt Definitions
  2741.  
  2742.     By highlighting a BBS ID and selecting "Prompts" from the top menu,
  2743.     you will be placed in a screen which details Robocomm's definitions
  2744.     for the prompt strings it will look for when connected with the
  2745.     currently highlighted BBS.  To change any of the definitions, use the
  2746.     up and down arrow keys to select the prompt text you would like to
  2747.     change.  Then press [Enter] to begin editing the prompt.
  2748.  
  2749.     RESETTING DEFAULT PROMPTS - To revert back to Robocomm's "Default"
  2750.     prompt definitions for the current BBS, select "Default" from the top
  2751.     menu.  After a confirmation, the prompts will be reset and you will be
  2752.     show the help text for the prompt set.
  2753.  
  2754.     IMPORTING PROMPT DEFINITION FILES - Robocomm has the ability to import
  2755.     prompt definitions from files called "Prompt Definition" files.  For
  2756.     PCBoard systems, these files have a PPF (PCBoard Prompt File)
  2757.     extension.  Similarly, the file name for Wildcat! prompt files is WPF.
  2758.  
  2759.     To import a prompt definition file select "Import" from the prompt
  2760.     screen menu.  Then, input the file name to import in the space
  2761.     provided, or press F10 for a list of the available prompt files in the
  2762.     Robocomm current directory.  Once you have told Robocomm what prompt
  2763.     file to import, the screen will clear and special notes regarding
  2764.     system setup with these prompt files will be displayed.  Make sure to
  2765.     read these notes carefully and follow any additional instructions they
  2766.     may provide.
  2767.  
  2768.     EXPORTING PROMPT DEFINITION FILES - If you have developed a set of
  2769.     prompt definitions that works well for a particular BBS, you can
  2770.     export the definitions from the Robocomm BBS directory to a Robocomm
  2771.     Prompt Definition file.  Just select "Export" from the prompts menu
  2772.     and then type in an 8 character name for the file. Robocomm will
  2773.     append a the appropriate extension to the file.  Before completing the
  2774.     export, Robocomm will enter a word processing mode where you can input
  2775.     notes about this prompt set.  Press Ctrl+Enter to save the notes and
  2776.     create the prompt definition file.  You can then upload the customized
  2777.     prompt set to the BBS for others to download and use with their copy
  2778.     of Robocomm!
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.     ______________________________________________________________________
  2787.     Robocomm 4.0 User's Guide                                      Page 44
  2788.  
  2789.  
  2790.  
  2791.  
  2792.        CREATING AND EDITING AGENDAS
  2793.  
  2794.     By setting up "Agendas" of "things to do," you tell Robocomm what it's
  2795.     objectives should be when it goes on-line.  Agendas are very flexible.
  2796.     In fact, their potential size is unlimited.  If you had the time,
  2797.     resources and inclination, you could set up an agenda to call
  2798.     literally thousands of PCBoard and Wildcat! BBS systems automatically.
  2799.  
  2800.     CREATING A NEW AGENDA - To create a new agenda, select Agenda,
  2801.     followed by Create from the main menu.  Robocomm will ask you to enter
  2802.     a unique name, up to ten characters long, for the new agenda.
  2803.     Immediately after you enter the name, you will be taken to the agenda
  2804.     modification screen to create your new agenda.  The following screen
  2805.     shows a typical agenda modification session:
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.     TEMPORARY, PERMANENT & DONE AGENDA ITEMS - All items that you add to
  2832.     your agenda are classified as either "Temporary" or "Permanent" as you
  2833.     add them.  Temporary agenda items, indicated by a diamond character
  2834.     (standard mode) or an inverse video T (VGA font loaded) , are removed
  2835.     from the agenda after they are successfully completed by Robocomm.
  2836.     Permanent agenda items, indicated by a half block (standard mode) or
  2837.     inverse video P,  remain on the agenda even after they are completed,
  2838.     so that they may be used again.  You can toggle the
  2839.     temporary/permanent status of any agenda item by highlighting it and
  2840.     pressing the "-" (minus sign or dash) key.
  2841.  
  2842.  
  2843.  
  2844.     ______________________________________________________________________
  2845.     Robocomm 4.0 User's Guide                                      Page 45
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.     When a permanent agenda item is completed by Robocomm, its bullet
  2852.     character on the agenda is replaced by a check mark. Completed agenda
  2853.     items will not be attempted again until the agenda is "reset" (more on
  2854.     this later) or until their "Done" status is toggled to "To Do" status
  2855.     by highlighting the agenda item and pressing either "+" (plus sign or
  2856.     equal sign) key on your keyboard.
  2857.  
  2858.     DELETING AGENDA ITEMS - To delete an agenda item, simply use the up
  2859.     and down arrow keys to highlight the agenda item to delete and press
  2860.     the [Del] key. To delete all agenda items for a BBS, simply highlight
  2861.     the "Call <BBS Name>" agenda item and press [Del].
  2862.  
  2863.     SETTING ACTION DAYS - You can specify taht an agenda itemonly run on
  2864.     certain days of the week by highlighting an agenda item and pressing
  2865.     [Alt-D]. A window will pop-up with a list of the days of the week.
  2866.     Select the days you want the item to execute and press enter.   You
  2867.     can also highlight an agenda item and press [Alt-E] to set the item to
  2868.     excecute every day or [Alt-N] to set the item to never execute.
  2869.  
  2870.     MOVING AGENDA ITEMS - In Robocomm's agendas you can place items for an
  2871.     individual BBS in any order.  To do so, use the [Tab] and [Shift-Tab]
  2872.     keys.  The [Tab] key will move the highlighted agenda item down the
  2873.     list and the [Shift-Tab] key will move an item up the list.  DOS 5.0
  2874.     users with enhanced keyboards can also use [Ctrl+Up] and [Ctrl+Down]
  2875.     to move agenda items.  By default, the agenda items are placed at the
  2876.     end of the list as you add them. Also, you can quickly move the cursor
  2877.     to the next or previous BBS in the agenda by pressing the [Enter] and
  2878.     [Backspace] keys respectively.
  2879.  
  2880.  
  2881.  
  2882.  
  2883.          NOTE:     Consider the order of the items on your agenda
  2884.                    carefully.  Try and group all items that use a similar
  2885.                    door together.  Place your mail send and receive
  2886.                    commands next to each other.  Try to group all commands
  2887.                    that use the same BBS resources consecutively.  That
  2888.                    way Robocomm won't be bouncing all over the board to
  2889.                    get things done.
  2890.  
  2891.  
  2892.  
  2893.  
  2894.     USING THE AGENDA MODIFICATION MENUS - The menu on the bottom of the
  2895.     screen lists all of the pre-defined actions that Robocomm can perform
  2896.     while on-line.  You build the agenda of "Things to Do" by pressing any
  2897.     of the keys listed in the agenda commands window and answering the
  2898.     prompts which appear.  The following is a summary of all of the
  2899.     commands which are available.
  2900.  
  2901.     G    GET QWK MAIL PACKET - Robocomm will prompt you for the ID of the
  2902.     ______________________________________________________________________
  2903.     Robocomm 4.0 User's Guide                                      Page 46
  2904.  
  2905.  
  2906.  
  2907.  
  2908.          system to get the QWK packets from.  You can press [F10] at this
  2909.          prompt to select from a pop-up list of all the systems in you
  2910.          systems database if you wish.  This agenda item defaults to
  2911.          permanent status.  Robocomm is compatible with most mail doors
  2912.          which support the QWK packet standard, such as Qmail 4.0,
  2913.          MarkMail (all versions) and RoseMail.  .
  2914.  
  2915.  
  2916.  
  2917.  
  2918.          NOTE:     For safety reasons while on-line in unattended mode,
  2919.                    Robocomm does not support the "Automatic Re-Scan"
  2920.                    feature of many mail doors, which will automatically
  2921.                    scan and send a new packet if the first mail scan
  2922.                    didn't include all waiting messages. If you want to
  2923.                    receive multiple mail packets in a single session, you
  2924.                    can schedule as many individual "Get Packet" agenda
  2925.                    items as you like
  2926.  
  2927.  
  2928.  
  2929.  
  2930.     S    SEND REPLY REP PACKET - Robocomm will prompt you for the ID of
  2931.          the system to send replies to.  If there is a .REP reply packet
  2932.          waiting to be sent to this BBS, then the agenda item will be
  2933.          followed by a "Packet Waiting" message in the agenda window.
  2934.          This agenda item defaults to permanent status.
  2935.  
  2936.          If the only agenda item for a particular system is "Send Replies
  2937.          Packet" and no reply packet is waiting to be sent to that system
  2938.          when the agenda is run, Robocomm will not dial that BBS.  This
  2939.          allows you to create a "REPLY" agenda which contains only "Send
  2940.          Qmail Replies" agenda items for several systems.  When the agenda
  2941.          is run, Robocomm will dial only the systems which have replies to
  2942.          be sent and deliver your replies.  You can reuse such an agenda
  2943.          over and over again to deliver your replies without downloading
  2944.          other messages or calling systems unnecessarily.
  2945.  
  2946.     M    PCRELAY/MEGAMAIL TRANSFERS - Robocomm has the ability to transfer
  2947.          mail with both PCRelay and MegaMail mail doors.  The PCRelay door
  2948.          is for Sysops who are transferring network mail, and the MegaMail
  2949.          door is a general purpose offline mail door for BBS users.  The
  2950.          operating principals off both doors is identical.  Upon opening
  2951.          the door, Robocomm will look for the word "RECEIVE" or the two
  2952.          asterisks in a Zmodem transfer header.  At this time Robo will
  2953.          drop to DOS and execute the OUT batch file you specify with the
  2954.          following parameters:
  2955.  
  2956.                    %1   The current communications port
  2957.                    %2   The current baud rate
  2958.                    %3   The ID of the BBS being called
  2959.  
  2960.     ______________________________________________________________________
  2961.     Robocomm 4.0 User's Guide                                      Page 47
  2962.  
  2963.  
  2964.  
  2965.  
  2966.          After the Upload has been completed, Robocomm will look for the
  2967.          word "SEND" or the same DSZ header and drop to DOS to execute the
  2968.          IN batch file you specify with the same parameters as above.
  2969.          When the download is finished the doors return you to PCBoard.
  2970.          That's all there is to it!
  2971.  
  2972.          PCRelay Configuration - Set your "Comm Directory" option in the
  2973.          CONFIG.EXE program to your Robocomm subdirectory.  Then create
  2974.          two batch files to send and receive your mail.  The examples
  2975.          below are in use on Group One BBS.  You will need to alter the
  2976.          batch file to indicate your system ID, as shown with the
  2977.          underlined items:
  2978.  
  2979.               RELAYOUT.BAT
  2980.               dsz port %1 speed %2 ha both sz GROUPONE.rly
  2981.  
  2982.               RELAYIN.BAT
  2983.               dsz port %1 speed %2 ha both rz IN.rly
  2984.  
  2985.          MegaMail - MegaMail is implemented similarly to the network mail
  2986.          door, but requires slightly more complicated batch files that you
  2987.          will have to edit for your system.  Here are the sample batch
  2988.          files included with Robocomm:
  2989.  
  2990.               MEGAOUT.BAT
  2991.               DSZ port %1 speed %2 ha both pB4096 sz \mega\up\%3.ul
  2992.               IF ERRORLEVEL 1 GOTO END
  2993.               COPY \mega\up\%3.ul \mega\up\%3.old
  2994.               del \mega\up\%3.ul
  2995.               :END
  2996.  
  2997.               MEGAIN.BAT
  2998.               IF EXIST \MEGA\DOWN\%3.DL DEL \MEGA\DOWN\%3.DL > nul
  2999.               DSZ port %1 speed %2 ha both pB4096 rz \mega\down\%3.dl
  3000.  
  3001.               To edit these files for your system, just replace all
  3002.               instances of "\MEGA\DOWN" with the location of your MegaMail
  3003.               receive directory and "\MEGA\UP" with the location of your
  3004.               MegaMail send directory.
  3005.  
  3006.  
  3007.     D    DOWNLOAD A FILE - Use this agenda item to download from any of
  3008.          your defined BBS systems.  Robocomm will prompt you for the name
  3009.          of the file to download.  Press [F10] at this prompt if you would
  3010.          like to choose one or more files from Robocomm's own Available
  3011.          Files directory.  While you are in the directory, you can select
  3012.          one file and press [Enter], or use the space bar to "Tag"
  3013.          multiple files for downloading.   While in the file directory,
  3014.          you can see a summary of your tagged files, by pressing [Alt-T].
  3015.  
  3016.          If you select multiple files, Robocomm will ask your permission
  3017.          to automatically create download agenda items for all the files
  3018.     ______________________________________________________________________
  3019.     Robocomm 4.0 User's Guide                                      Page 48
  3020.  
  3021.  
  3022.  
  3023.  
  3024.          that you have tagged.  All of the automatically created download
  3025.          items will default to temporary status.
  3026.  
  3027.          If you selected only one file from the new files list or you are
  3028.          entering a file name manually, Robocomm may also ask for the name
  3029.          or number of the conference to join before attempting the
  3030.          download.  After indicating the conference, Robocomm will prompt
  3031.          you for a password for downloading the file.  If a password will
  3032.          be necessary, enter it here.  Finally, Robocomm will ask you to
  3033.          choose temporary or permanent status for this agenda item.  Enter
  3034.          "T" or "P" respectively.
  3035.  
  3036.          If you are downloading from a PCBoard BBS and have specified a
  3037.          ProDoor number on the Directory-BBS screen for this system,
  3038.          Robocomm will open ProDoor before downloading the file.
  3039.  
  3040.  
  3041.  
  3042.  
  3043.          NOTE:     When Robocomm is processing your agenda while on-line,
  3044.                    it will not attempt to download a file if it already
  3045.                    exists in your specified download directory.  That way,
  3046.                    you can tell Robocomm to download the same file from
  3047.                    multiple BBS systems and when it gets the file, it will
  3048.                    not attempt to download it from other systems on the
  3049.                    agenda which have yet to be called.  If you've
  3050.                    absolutely, positively have to have that file
  3051.                    overnight, Robocomm can do it all for you while you
  3052.                    sleep!
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.          POST CALL DOWNLOADED FILE PROCESSING - After a call to a BBS has
  3059.          been completed, Robocomm will check to see if the file
  3060.          FIXFILE.BAT exists in your Robocomm subdirectory, If it does,
  3061.          Robocomm will automatically run it on all files that it
  3062.          downloaded via the "Download File" agenda items.
  3063.  
  3064.          Robocomm supplies two parameters to the batch file:
  3065.  
  3066.               %1   The name of the file
  3067.               %2   The file extension of the file
  3068.  
  3069.          Robocomm is shipped with a default FIXFILE.BAT file which
  3070.          contains the following command:
  3071.  
  3072.               pkzip -z %1 <comment.txt
  3073.  
  3074.          This FIXFILE.BAT routine updates the ZIPfile comment, and also
  3075.          uses another of Robocomm's post download features, which is the
  3076.     ______________________________________________________________________
  3077.     Robocomm 4.0 User's Guide                                      Page 49
  3078.  
  3079.  
  3080.  
  3081.  
  3082.          ability to create customized merged comments for all downloaded
  3083.          archive files..  Before Robocomm executes FIXFILE.BAT, it looks
  3084.          for a file called COMMENT.FRM, which it will merge with
  3085.          information specific to the downloaded file to create
  3086.          COMMENT.TXT.  The default COMMENT.FRM that comes with Robocomm
  3087.          looks like this:
  3088.  
  3089.               ===================== Robocomm Download Information
  3090.                    ====================
  3091.               Downloaded By:      {USER}
  3092.               Downloaded from:    {ID} - {BBS}
  3093.               File name on BBS:   {FILE}
  3094.               Download date: {DATE}
  3095.               ------------------------------------------------------------
  3096.               -----------------------------------
  3097.               DESCRIPTION}
  3098.               ============================================================
  3099.               ==========
  3100.  
  3101.          If you like, you can modify the file to create your own
  3102.          customized ZIPfile comments in all the files downloaded by
  3103.          Robocomm.  Robocomm merges the text in COMMENT.FRM by looking for
  3104.          key fields, contained in curly braces.  The fields you can
  3105.          include in the comment form are:
  3106.  
  3107.               {USER}         The name used to log on to the BBS
  3108.               {ID}           The mail ID of the system
  3109.               {BBS}               The name of the BBS
  3110.               {FILE}              The name of the file
  3111.               {DATE}         The date of the download
  3112.               {DESCRIPTION}  The multi-line description of the file.
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.          NOTE:     Robocomm's post-call file processing behavior will
  3119.                    differ depending upon whether or not the COMMENT.FRM
  3120.                    file exists.  If it does, then Robocomm will swap out
  3121.                    to FIXFILE.BAT one time for each file downloaded during
  3122.                    the session.  This is because it must re-merge
  3123.                    COMMENT.TXT between each file.  If you elect to forego
  3124.                    automatic zip comment creation, Robocomm will shell out
  3125.                    one time, running a batch file which CALLs FIXFILE.BAT
  3126.                    repeatedly.
  3127.  
  3128.  
  3129.  
  3130.  
  3131.     U    UPLOAD A FILE - Use this agenda item to Upload a file to a BBS.
  3132.          Robocomm starts off by asking you to supply a filename. The field
  3133.          already contains the drive and path specifications of your
  3134.     ______________________________________________________________________
  3135.     Robocomm 4.0 User's Guide                                      Page 50
  3136.  
  3137.  
  3138.  
  3139.  
  3140.          default upload directory, but you can backspace over this to
  3141.          enter any valid path and filename.  If you would like to select
  3142.          from a pop-up directory listing, simply press [Shift-F10].
  3143.          Robocomm will search the path and file specification you enter
  3144.          for matches.  You can enter any valid wildcard filename and path.
  3145.          If you omit the file specification, Robocomm will default to
  3146.          "*.*".
  3147.  
  3148.          Alternatively, you can press [F10] to select from Robocomm
  3149.          Downloaded Files directory, which contains entries for all the
  3150.          files you have previously downloaded or uploaded with Robocomm.
  3151.          Use the space bar to tag multiple files to be uploaded or
  3152.          highlight a single file and press [Enter] to create the upload
  3153.          agenda item(s).  While you're in the directory you might want to
  3154.          use the E command to edit the description of the file to get it
  3155.          just right.  If the file had previously been moved to a diskette
  3156.          with Robocomm's Offline command, Robocomm will prompt you to
  3157.          insert the diskette with the file so it can be copied to the
  3158.          computer's hard disk again.
  3159.  
  3160.          After returning to the agenda screen, Robocomm may ask you to
  3161.          supply a description of this file for use during the upload.
  3162.          Finally, specify the BBS to call, conference to join and the
  3163.          temporary/permanent status of this agenda item, as described
  3164.          previously.  If you are uploading to a PCBoard BBS with a ProDoor
  3165.          specified, Robo will open ProDoor before uploading the file.
  3166.  
  3167.          If you are uploading to a Wildcat system and you have set the
  3168.          File Upload Area option on the Directory-BBS screen to A or left
  3169.          it blank, Robocomm will pop-up a box asking you to assign an area
  3170.          number to the file.  You must assign an area number.  If the BBS
  3171.          requests one and Robocomm does not have one to supply, the agenda
  3172.          item will be aborted.
  3173.  
  3174.  
  3175.  
  3176.  
  3177.          HINT:     :    For Wildcat systems that require the user to
  3178.                    select the appropriate upload area, you might find it
  3179.                    helpful to go on-line manually and use CAPTURE FILE
  3180.                    feature of Robocomm's terminal to make a .CAP file
  3181.                    containing the file upload areas that are available.
  3182.                    Then, you can press F9 at the upload area prompt, and
  3183.                    Robocomm will show you the capture file to refresh your
  3184.                    memory.
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.     ______________________________________________________________________
  3193.     Robocomm 4.0 User's Guide                                      Page 51
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.          NOTE::    Robocomm will send the entire description of the file
  3202.                    if you are uploading to ProDoor or PCBoard version 14.5
  3203.                    or above.  Wildcat BBS systems receive only the first
  3204.                    displayed description line as their "primary"
  3205.                    description, and Robocomm will send the entire
  3206.                    description as an "Extended" description.  PCBoard 14.2
  3207.                    systems can only accept single line file descriptions.
  3208.                    You should take this into account when composing your
  3209.                    upload descriptions. To make them as flexible as
  3210.                    possible, the first line should be able to stand on its
  3211.                    own, with extra lines offering supporting information.
  3212.  
  3213.  
  3214.  
  3215.  
  3216.          BROADCASTING FILES TO MULTIPLE BBS SYSTEMS - Robocomm has the
  3217.          ability to upload a file to multiple Bulletin Boards without
  3218.          requiring you to compose a separate agenda item for each system.
  3219.          To do this, press [F10] when Robocomm asks for the ID of the
  3220.          system to upload to.  While the pop-up listing is displayed, you
  3221.          can use the space bar to Tag/Untag the systems that you want to
  3222.          upload the file to.  When you have selected all the systems you
  3223.          want, press [Enter] and Robocomm will automatically create upload
  3224.          agenda items for each system you tagged.  If you combine this
  3225.          feature with the tagging of multiple files to upload, Robocomm
  3226.          will create agenda items for each file on each BBS, all
  3227.          automatically!
  3228.  
  3229.  
  3230.  
  3231.  
  3232.          NOTE:     When using the Broadcast mode, Robocomm will use the
  3233.                    conference stored in the File Conference option on the
  3234.                    Directory-BBS screen for each BBS tagged and all upload
  3235.                    agenda items will be assigned temporary status.
  3236.  
  3237.  
  3238.  
  3239.  
  3240.          AUTOMATIC DOWNLOAD DIRECTORY ENTRIES - Whenever you enter a file
  3241.          to upload in Robocomm and there is no matching entry in your
  3242.          "Downloads" directory, Robocomm creates an entry for you
  3243.          automatically.  This entry is used to hold the extended
  3244.          description, and will enable you to simply pick from the list and
  3245.          the file description will be supplied automatically the next time
  3246.          you upload this file.
  3247.  
  3248.  
  3249.     N    SCAN FOR NEW FILES - You can add to Robocomm's "New Files"
  3250.     ______________________________________________________________________
  3251.     Robocomm 4.0 User's Guide                                      Page 52
  3252.  
  3253.  
  3254.  
  3255.  
  3256.          database by scanning for new files on the BBS systems that you
  3257.          call.  When you specify this agenda item, Robocomm will ask you
  3258.          to supply the ID of BBS to call.  Type in the ID of the system,
  3259.          or press [F10] to select from a list.  Next, enter the date to
  3260.          scan forward from -- use an "S" for "since last logon" or type in
  3261.          a date in the format MMDDYY, where MM is the month from 1 to 12,
  3262.          DD is the day from 0 to 31, and YY is the last two digits of the
  3263.          year (i.e. "89" for 1989).  As an example, you would enter
  3264.          "021089" to scan for all files since February 10, 1989.
  3265.  
  3266.          Next, Robocomm will ask you to specify the directories to search.
  3267.          Wildcat systems default to "A" for All Directories.  For PCBoard
  3268.          systems, the default is "U" for the BBS's "Recent Uploads"
  3269.          directory.  You can change this to "A" to search "All" available
  3270.          file directories, or you can specify the directories to search
  3271.          individually, by specifying their numbers, separated by semi-
  3272.          colons.  Make sure that the string you enter contains valid
  3273.          directory numbers for the BBS and also that it doesn't contain
  3274.          any imbedded spaces.  For example:
  3275.  
  3276.               A              All Directories
  3277.               U              Upload Directory (PCBoard Only)
  3278.               3              Directory 3
  3279.               2;3;5;7;9;11        Directories 2,3,5,7,9 and 11
  3280.  
  3281.  
  3282.  
  3283.  
  3284.          NOTE:     On some BBS systems, the "Uploads" directory is
  3285.                    private, so the Sysop can screen files before posting
  3286.                    them on the BBS.  If this is the case, you will not be
  3287.                    able to scan recent uploads by specifying "U" for the
  3288.                    New files Scan.  To scan the uploads on these systems,
  3289.                    simply specify the number of the system's alternate
  3290.                    "Upload" directory explicitly.
  3291.  
  3292.  
  3293.  
  3294.  
  3295.     J    JUMP TO TERMINAL MODE - When Robocomm prompts you for the ID of
  3296.          the systems you want to enter terminal mode on, you can either
  3297.          enter an ID, or press F10 to select one or more BBS systems.
  3298.          When the agenda is running, this agenda item will cause Robocomm
  3299.          to go into ANSI terminal mode and sound an alarm to alert you.
  3300.          The type of sound used is controlled by the Speaker Sound Style
  3301.          option on the General Configuration screen.  As a safety feature,
  3302.          if Robocomm jumps to terminal during an agenda and doesn't get
  3303.          the attention it desires from a live person with 1 minute, it
  3304.          will return to automated agenda processing automatically and put
  3305.          a disgruntled notation to that effect in the status log.
  3306.  
  3307.  
  3308.     ______________________________________________________________________
  3309.     Robocomm 4.0 User's Guide                                      Page 53
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.          NOTE:     Since, Robocomm's terminal mode Demon Dialer doesn't
  3318.                    allow you to specify PC Pursuit systems, you can create
  3319.                    an agenda which contains "Jump to Terminal" agenda
  3320.                    items for PC Pursuit systems to create the same effect.
  3321.                    This will allow you to dial systems repeatedly ,
  3322.                    through the PC Pursuit network.
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.     C    CAPTURE COMMAND RESULT - This is Robocomm's most flexible agenda
  3329.          item.  With it, you can send a command or capture the results of
  3330.          almost any PCBoard or Wildcat command to a capture file for
  3331.          browsing after you log off.  The first question Robocomm asks
  3332.          when you press "C" at the agenda creation and modification screen
  3333.          is the command to capture.  If you need to send a carriage return
  3334.          during the capture command, include the pipe character "|" in the
  3335.          appropriate place in the capture command.
  3336.  
  3337.          For example, on PCBoard systems, you could enter any one of the
  3338.          following:
  3339.  
  3340.          T;#       Where # is the letter of the protocol that you want
  3341.                    PCBoard and/or ProDoor to use for file transfers. Make
  3342.                    sure that your file transfer batch files for this
  3343.                    system (on the Directory-BBS screen) match this new
  3344.                    protocol letter and that this item comes BEFORE any
  3345.                    upload or download agenda items!
  3346.  
  3347.          B         A listing of the Bulletins available on the system.
  3348.  
  3349.          B;#       Capture an individual bulletin by number, where # is
  3350.                    the number of the bulletin to capture.
  3351.  
  3352.          F         A listing of the file directories available on the
  3353.                    system -- also very valuable when creating agendas.
  3354.  
  3355.          F;#       A listing of a specific file directory.  For example,
  3356.                    to view all the files in directories 3 and 5, you would
  3357.                    specify:
  3358.  
  3359.                         F;3;5
  3360.  
  3361.          I         The initial Logon screen, which usually contains
  3362.                    information on the Sysop, and the BBS phone numbers.
  3363.  
  3364.          J         A listing of all conferences available on the BBS, and
  3365.                    their numbers.  This information is very useful when
  3366.     ______________________________________________________________________
  3367.     Robocomm 4.0 User's Guide                                      Page 54
  3368.  
  3369.  
  3370.  
  3371.  
  3372.                    creating agendas.
  3373.  
  3374.          L         Locate a file by wildcard filename.  The full command
  3375.                    you specify will be made up of three parts, separated
  3376.                    by semicolons.  For example:
  3377.  
  3378.                         L;ROBO*.*;A
  3379.  
  3380.                    would search through all file directories on the BBS
  3381.                    for any file starting with ROBO.  To search specific
  3382.                    directories, simply specify the directories to search,
  3383.                    separated by semicolons. For example to search in only
  3384.                    directories 1, 3 & 7 you would specify:
  3385.  
  3386.                         L;ROBO*.*;1;3;7
  3387.  
  3388.  
  3389.  
  3390.  
  3391.                    NOTE:     You can add the results of this search to
  3392.                              your available files database by using the
  3393.                              "E" agenda command to execute the
  3394.                              MAKELIST.BAT file supplied with Robocomm
  3395.                              immediately after the capture command. Or, by
  3396.                              using the Import command on the Available
  3397.                              Files screen.
  3398.  
  3399.  
  3400.  
  3401.  
  3402.          NEWS Enter this command to capture the BBS news file.
  3403.  
  3404.          S         A list of script questionnaires available.
  3405.  
  3406.          R         Read messages.  Many variations on this command are
  3407.                    possible.  Note that a simple "R" won't accomplish
  3408.                    anything.  For example:
  3409.  
  3410.                    R;S       All messages posted since last read.
  3411.                    Y;S;A          Read messages posted for you since your
  3412.                              last log on.
  3413.                    R;100+    Read messages with number > 100.
  3414.                    R;100-    Read messages with number < 100.
  3415.                    R;F;S          Messages you have posted since last
  3416.                                             read.
  3417.  
  3418.                    The "conference" option on the capture command agenda
  3419.                    item will allow you to read messages in any PCBoard
  3420.                    conference that you have access to.
  3421.  
  3422.          Z         Scan for text in the directory listings.  This command
  3423.                    works the same as the "L" command described above,
  3424.     ______________________________________________________________________
  3425.     Robocomm 4.0 User's Guide                                      Page 55
  3426.  
  3427.  
  3428.  
  3429.  
  3430.                    except that you specify text to search for instead of a
  3431.                    filespec.  For example, to find all occurrences of
  3432.                    FORMAT in all file directories you could enter:
  3433.  
  3434.                         Z;FORMAT;A
  3435.  
  3436.                    Because of the way PCBoard 14 parses commands, the text
  3437.                    you search for must be 1 word, with no spaces.
  3438.  
  3439.  
  3440.  
  3441.  
  3442.                    NOTE:     You can add the results of this search to
  3443.                              your available files database by using the
  3444.                              "E" agenda command to execute the
  3445.                              MAKELIST.BAT file supplied with Robocomm
  3446.                              immediately after the capture command. Or, by
  3447.                              using the Import command on the Available
  3448.                              Files screen.
  3449.  
  3450.  
  3451.  
  3452.  
  3453.          After you have specified the command that you would to issue,
  3454.          Robocomm will ask you if you want to capture the results to a CAP
  3455.          file.  If you answer yes, Robocomm will ask if it should append
  3456.          to or overwrite any existing CAP file for this BBS. Finally,
  3457.          Robocomm will ask you to specify the system to call, the
  3458.          conference to join before issuing the command to capture and the
  3459.          permanent/temporary status of this agenda item.
  3460.  
  3461.  
  3462.     P    DOWNLOAD PCBMail PACKET - Robocomm has the ability to download
  3463.          compressed capture files of messages from PCBoard 14.5 systems by
  3464.          issuing a R;A;Z command at the PCBoard Main Board command prompt
  3465.          and downloading the resulting compressed capture file. It will be
  3466.          given the same name as the BBS ID with a .PCB extension.  As they
  3467.          are received, the packets are automatically renumbered, just like
  3468.          QWK packets and are placed in your defined QWK directory.
  3469.  
  3470.  
  3471.  
  3472.  
  3473.          NOTE:     To select the conferences that will be scanned by this
  3474.                    command issue the SELECT command at the PCBoard Main
  3475.                    Board command prompt.
  3476.  
  3477.  
  3478.  
  3479.  
  3480.     R    RUN PROGRAM - During an agenda, you can shell to DOS and execute
  3481.          an external process with this agenda item.  Robocomm will ask you
  3482.     ______________________________________________________________________
  3483.     Robocomm 4.0 User's Guide                                      Page 56
  3484.  
  3485.  
  3486.  
  3487.  
  3488.          for the command to execute while in DOS.  "Why would I want to do
  3489.          that," you ask?  One example is to add the results of "Z" or "L"
  3490.          capture commands to Robocomm's new file list.  The SAMPLE agenda
  3491.          shipped with Robocomm demonstrates this.  Immediately after
  3492.          executing a capture of a Z;ROBO;A command, the agenda shells to a
  3493.          batch file called MAKELIST.BAT which appends the current contents
  3494.          of the BBS's capture file to a file called NEWLIST.DAT.  The
  3495.          batch file contains the following lines:
  3496.  
  3497.             @ECHO OFF
  3498.             ECHO Appending %BBS%.CAP to NEWLIST.DAT now...
  3499.             TYPE %BBS%.CAP >> NEWLIST.DAT
  3500.             ERASE %BBS%.CAP
  3501.  
  3502.          In this example, DOS expands the %BBS% variable to the BBS ID of
  3503.          the system as configured by Robocomm.  This works because at the
  3504.          end of each call with a BBS, Robocomm looks for a file called
  3505.          NEWLIST.DAT.  If it exists, Robocomm will scan it into the New
  3506.          Files list indicating that the file is available on the BBS that
  3507.          it just disconnected from.
  3508.  
  3509.          Whenever Robocomm passes control to DOS via the "Run Program"
  3510.          agenda item, it places the following environment variables into a
  3511.          transient copy of the environment that existed before Robocomm
  3512.          was started:
  3513.  
  3514.               BBS            The ID of the currently connected BBS
  3515.               BAUD           The current host-modem connection speed
  3516.               DOW            The day of week, i.e. MONDAY, TUESDAY, etc.
  3517.               MAILUP         Your REP Directory
  3518.               MAILDOWN       Your QWK Directory
  3519.               FILEUP         Your File Uploads Directory
  3520.               FILEDOWN       Your File Downloads directory
  3521.  
  3522.  
  3523.  
  3524.  
  3525.          NOTE:     The program you run from within an agenda MUST return
  3526.                    control to DOS when it completes so Robocomm can
  3527.                    continue on with its agenda.  Remember -Robocomm is
  3528.                    still connected with the BBS when executing this agenda
  3529.                    item.  If you execute a process that hangs or that
  3530.                    requires a key press at some point it will be up to the
  3531.                    BBS to hang up on you.  Robocomm is not in control of
  3532.                    the process and can't hang up for you!
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.     E    EXECUTE SCRIPT - Robocomm includes a full-featured script
  3539.          language that you can use to automate tasks other than those
  3540.     ______________________________________________________________________
  3541.     Robocomm 4.0 User's Guide                                      Page 57
  3542.  
  3543.  
  3544.  
  3545.  
  3546.          provided for in Robocomm's "hard coded" agenda items.  When you
  3547.          create this agenda item, Robocomm will pop-up a box asking you
  3548.          for the name of the script you want to execute.  If you know the
  3549.          name of the script file you want to execute, type it in.  To
  3550.          select from a list, press [F10].  Robocomm will pop-up a window
  3551.          listing all files in the Robocomm directory with a .RS extension.
  3552.          Use the up and down arrows to select the script you want to
  3553.          execute.
  3554.  
  3555.          Editing Scripts - If the script you are selecting will require
  3556.          editing prior to being run, or if you need to view it for further
  3557.          explanation of its usage, press the E key while the script name
  3558.          is highlighted.  An editor will pop-up with the script file
  3559.          loaded.  When you are done viewing/editing the script, press
  3560.          [Esc] to return to the script selection window.
  3561.  
  3562.          Editing Script Parameters - After you select a script file,
  3563.          Robocomm may require additional information, which will be used
  3564.          to customize the script's behavior.  These bits of information
  3565.          are called Script Parameters and they are linked to each
  3566.          individual Execute Script agenda item.  If the script requires
  3567.          parameters to run, Robocomm will pop-up a window containing a
  3568.          series of questions.  Use the up and down arrow keys to select
  3569.          the question to answer, and press [Enter] to edit your answer.
  3570.          When all of the questions have been answered, press [Esc] and
  3571.          Robocomm will return you to the agenda editing screen.
  3572.  
  3573.          You can view the parameters linked to every Execute Script agenda
  3574.          item by highlighting the agenda item and pressing [Alt-P].
  3575.          Robocomm will pop-up the parameter editing window and allow you
  3576.          to make whatever changes you wish.
  3577.  
  3578.  
  3579.  
  3580.  
  3581.          NOTE:     For complete documentation on creating custom scripts
  3582.                    Robocomm's script language, see the file SCRIPT.DOC,
  3583.                    which is included with the Robocomm distribution files.
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.     SAVING AN AGENDA- The displayed agenda is saved automatically each
  3590.     time you exit the Agenda Creation and Modification screen.  To exit
  3591.     the screen, just press "Q" or [Esc].
  3592.  
  3593.     EDITING AN AGENDA - To edit or review an existing agenda, just select
  3594.     the agenda to edit by selecting "Agenda" followed by "Set" at the main
  3595.     menu.  You can then type in the name of the agenda to make current or
  3596.     press [F10] to select from a pop-up list.  If the agenda you specify
  3597.     was not completed the last time it was run, Robocomm will ask you if
  3598.     ______________________________________________________________________
  3599.     Robocomm 4.0 User's Guide                                      Page 58
  3600.  
  3601.  
  3602.  
  3603.  
  3604.     you would like to reset all agenda items to "To Do" status, or
  3605.     continue from where you left off.
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.     ______________________________________________________________________
  3657.     Robocomm 4.0 User's Guide                                      Page 59
  3658.  
  3659.  
  3660.  
  3661.  
  3662.        PREPARING THE BBS FOR YOUR FIRST ROBOCOMM CALL
  3663.  
  3664.     Before you can use Robocomm to access a BBS, you must follow a few
  3665.     special steps to make sure that the BBS is set up the way Robocomm
  3666.     expects it.  There are different requirements for PCBoard and Wildcat
  3667.     systems.  Please make sure that you familiarize yourself with these
  3668.     requirements so that setting up BBS systems will be quick and simple.
  3669.  
  3670.     To start the setup process, go into Robocomm's interactive terminal
  3671.     mode and use the Dial command [Alt-D] to connect with the BBS.  Be
  3672.     prepared to make a few notes that you can refer back to after you log
  3673.     off.
  3674.  
  3675.     PCBOARD BBS SETUP PROCEDURE
  3676.  
  3677.     1. Language Selection - Take a look at the first prompt you receive
  3678.        from the BBS.  Is it asking you to select a language number?  If
  3679.        so, take a look at the displayed language menu and see if anything
  3680.        like "Standard Prompts" or "Scripting Prompts" is listed.  If it
  3681.        is, make a note of the language number indicated.  You should make
  3682.        sure to fill in that language number on Robocomm's Directory-BBS
  3683.        screen for this BBS.
  3684.  
  3685.     2. File Transfer Protocols - Use the "T" command from the PCBoard main
  3686.        menu to select the file transfer protocol that you intend to use to
  3687.        transfer files.  Make a note of the protocol you select, and make
  3688.        sure it matches the protocol indicated in the File Upload and File
  3689.        Download fields on the Directory-BBS screen for this BBS.
  3690.  
  3691.     3. Mail Door Selection - Type the word DOOR from the BBS's Main Menu
  3692.        or Conference Command prompt.  Take a look at the available mail
  3693.        doors.  If Qmail 4.0, MarkMail, RoseMail or CAM-Mail is listed, you
  3694.        will be able to use one of Robocomm's supplied prompt definition
  3695.        files to transfer QWK format mail with the BBS.  (Other QWK format
  3696.        doors can be used by customizing Robocomm's pre-defined prompt
  3697.        definitions.)  Make a note of the Door number and make sure it is
  3698.        filled in on the Directory-BBS screen.
  3699.  
  3700.  
  3701.  
  3702.  
  3703.          NOTE:     If the mail door you decide to use is not Qmail 4.0,
  3704.                    you will need to import a prompt definition file.  See
  3705.                    the Importing Prompts section of this manual for
  3706.                    details.
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.     4. Mail Door Setup - Enter the number of the mail door you plan to
  3713.        access and the BBS will load the door for you.  Follow the menus
  3714.     ______________________________________________________________________
  3715.     Robocomm 4.0 User's Guide                                      Page 60
  3716.  
  3717.  
  3718.  
  3719.  
  3720.        presented in the mail door to make sure you have set the following
  3721.        options:
  3722.  
  3723.             * Transfer protocol (usually Zmodem)
  3724.             * Archiving method (usually ZIP)
  3725.             * Conferences to scan
  3726.             * High message pointers
  3727.  
  3728.  
  3729.  
  3730.  
  3731.          NOTE:     If you want Robocomm to pull available files from the
  3732.                    QWK packet, make sure that the file scan option is also
  3733.                    set ON.  Be careful when getting new file lists from
  3734.                    the mail doors, however.  Often they will list files
  3735.                    which are not available from the main board.  When
  3736.                    importing new file lists from QWK packets, the
  3737.                    configured mail door conference will be assigned to all
  3738.                    imported files.  If the files listed in the QWK come
  3739.                    from other conferences, it's probably better to just
  3740.                    turn the file scanning OFF in the door and create
  3741.                    individual New File Scan agenda items for each
  3742.                    conference containing files you want to see.
  3743.  
  3744.  
  3745.  
  3746.  
  3747.     5. QWK Packet Name - By  using the download or upload options in the
  3748.        mail door, determine the name of the QWK packet that you will
  3749.        receive from the BBS.  The BBS ID you set up in Robocomm MUST match
  3750.        this BBS ID exactly.  If it doesn't use the Rename command on the
  3751.        Directory-BBS screen so the Robocomm ID matches the BBS's QWK mail
  3752.        ID exactly.
  3753.  
  3754.     6. Expert Mode - Before leaving the mail door, you should set Expert
  3755.        Mode ON.  In most mail doors, this will suppress the display of
  3756.        menus in future settings.  Once expert mode is set, quit back to
  3757.        the PCBoard Main Board prompt and use the X command to set Expert
  3758.        Mode ON in PCBoard as well.
  3759.  
  3760.     That's all there is to it!  The PCBoard BBS is now set up for Robocomm
  3761.     access.  Before running an agenda, you should check your notes against
  3762.     your Directory-BBS screen to make sure all the BBS settings agree with
  3763.     those in Robocomm.
  3764.  
  3765.     WILDCAT! BBS SETUP PROCEDURE
  3766.  
  3767.     To set up a Wildcat BBS, log in and go to the MAIN Menu prompt.  Next,
  3768.     issue the command required to access the Your Settings screen.
  3769.     Usually, this is the letter Y.  Once the screen is displayed, you will
  3770.     need to set or verify the following options:
  3771.  
  3772.     ______________________________________________________________________
  3773.     Robocomm 4.0 User's Guide                                      Page 61
  3774.  
  3775.  
  3776.  
  3777.  
  3778.     1. Birth Date and Phone Number - Make sure that the birth date and
  3779.        phone number displayed match those that you entered on Robocomm's
  3780.        General Configuration Screen.
  3781.  
  3782.     2. Hot Keys - This setting must be set to NO.  Robocomm sends a
  3783.        carriage return after all data sent to the BBS.  If the BBS reacts
  3784.        before Robocomm sends the carriage return, automated processing
  3785.        will not work.
  3786.  
  3787.     3. Color Menus - Setting this option to NO is not required, but it's a
  3788.        really good idea.  With color menus on, Wildcat sends a great deal
  3789.        of "ANSI codes" to Robocomm that are not required for automated
  3790.        processing.  The speed of your Wildcat agendas will be
  3791.        significantly increased if you set color menus off on all the
  3792.        Wildcat systems you call.
  3793.  
  3794.     4. File Transfer Protocol - Select Zmodem, Ymodem or Ymodem-G as your
  3795.        default transfer protocol.  Make sure that your selection matches
  3796.        the File Upload Protocol you defined on the Directory-BBS screen
  3797.        for this system.
  3798.  
  3799.     5. Help Level - It is essential that this option be set to Expert.
  3800.        This is the briefest menu format allowed by Wildcat.  It will speed
  3801.        your automated processing and reduce the chance of having a
  3802.        customized BBS prompt effect Robocomm's operations..
  3803.  
  3804.     6. Mail Door - There are a variety of ways to open mail doors on
  3805.        Wildcat systems.  Not all will be available on every system you
  3806.        call.  The most common way is through a menu option on the MESSAGE
  3807.        menu.  Check this menu for an option to "T"ransfer Mail or
  3808.        "D"ownload mail.  If no command is available from the message menu,
  3809.        try the main menu.  Sometimes, the mail door is only listed on the
  3810.        DOOR sub-menu of the main menu.  Once you've entered the mail door,
  3811.        make a note of how you got there, then use the mail door menus to
  3812.        make sure that the following options are set:
  3813.  
  3814.             * Transfer protocol (usually Zmodem)
  3815.             * Archiving method (usually ZIP)
  3816.             * Conferences to scan
  3817.             * High message pointers
  3818.  
  3819.  
  3820.  
  3821.  
  3822.          NOTE:     If you want Robocomm to pull available files from the
  3823.                    QWK packet, make sure that the file scan option is also
  3824.                    set ON.  Be careful when getting new file lists from
  3825.                    the mail doors, however.  Often they will list files
  3826.                    which are not available from the main board.  When
  3827.                    importing new file lists from QWK packets, the
  3828.                    configured mail door conference will be assigned to all
  3829.                    imported files.  If the files listed in the QWK come
  3830.     ______________________________________________________________________
  3831.     Robocomm 4.0 User's Guide                                      Page 62
  3832.  
  3833.  
  3834.  
  3835.  
  3836.                    from other conferences, it's probably better to just
  3837.                    turn the file scanning OFF in the door and create
  3838.                    individual New File Scan agenda items for each
  3839.                    conference containing files you want to see.
  3840.  
  3841.  
  3842.  
  3843.  
  3844.        QWK Packet Name - By  using the download or upload options in the
  3845.        mail door, determine the name of the QWK packet that you will
  3846.        receive from the BBS.  The BBS ID you set up in Robocomm MUST match
  3847.        this BBS ID exactly.  If it doesn't, use the Rename command on the
  3848.        Directory-BBS screen so the Robocomm ID matches the BBS's QWK mail
  3849.        ID exactly.
  3850.  
  3851.     Once you've determined the QWK packet ID and have verified the
  3852.     settings on all of the options listed above, log off the BBS and
  3853.     compare your notes with the information stored on the Directory-BBS
  3854.     screen.  Once everything matches up, you're ready to run an agenda
  3855.     commanding access to this BBS.
  3856.  
  3857.        RUNNING AN AGENDA
  3858.  
  3859.     Now the easy part.
  3860.  
  3861.     To run an agenda, you must select an agenda to make current by
  3862.     selecting the Set command from the Agenda menu.  Once you have done
  3863.     that, select Go from the main menu, followed by Run Agenda Now or Run
  3864.     Agenda Later.  To begin execution of your agenda immediately, select
  3865.     "Now."  If you select "Later," Robocomm will ask you to specify the
  3866.     time and date that you would like the agenda to begin.  Enter a time
  3867.     in the format HH:MM in military time and a date in MM/DD/YY format.
  3868.     For example, 02:00 is 2AM and 14:00 is 2PM.  If the time and date you
  3869.     enter has already passed, Robocomm will start immediately.
  3870.  
  3871.     That's all there is to it. Now, just relax and let Robo do the rest!
  3872.  
  3873.  
  3874.     PREAGEN.BAT and POSTAGEN.BAT Processing
  3875.  
  3876.     Before starting an agenda, Robocomm will look for the existence of a
  3877.     PREAGEN.BAT file in its directory.  If it finds the file, it will run
  3878.     it before every agenda.
  3879.  
  3880.     Similarly, Robocomm will look for the existence of a POSTAGEN.BAT
  3881.     file, which, if it is found,  will be run at the conslusion of all
  3882.     agendas.
  3883.  
  3884.     These batch files are useful for a variety of purposes, but perhaps
  3885.     the most important is to disable and re-enable delayed or staged
  3886.     writes on disk caches.  If you see "checksum error" on the screen
  3887.     during file transfers and you are using a disk cache with delayed or
  3888.     ______________________________________________________________________
  3889.     Robocomm 4.0 User's Guide                                      Page 63
  3890.  
  3891.  
  3892.  
  3893.  
  3894.     staged writes, you should consider using the PREAGEN.BAT file to
  3895.     disable the delayed writes at the start of an agenda.
  3896.  
  3897.  
  3898.        WHILE AN AGENDA IS RUNNING
  3899.  
  3900.     While the agenda is running, several special keys are active. Whenever
  3901.     the redial window is displayed on the screen, you can press any of the
  3902.     following keys:
  3903.  
  3904.          [Esc]     Stop dialing and interrupt the agenda. Remember, that
  3905.                    later you can resume this agenda from where you left
  3906.                    off by simply starting the agenda again.
  3907.  
  3908.          [Space]   By pressing the space bar, you can cause Robocomm to
  3909.                    skip over the currently displayed BBS. Robocomm will
  3910.                    attempt to re-dial this BBS the next time it comes up
  3911.                    in the agenda dialing queue.
  3912.  
  3913.          [Del]     To remove the currently displayed BBS from the dialing
  3914.                    queue, press the delete key while the BBS is displayed
  3915.                    in the redial window.  If you restart this agenda again
  3916.                    later, Robocomm will attempt to dial the previously
  3917.                    removed BBS.
  3918.  
  3919.  
  3920.     PC PURSUIT DIALING - If your agenda includes some systems that will be
  3921.     called direct and some systems that will be called through PC Pursuit,
  3922.     Robocomm will group each set of systems together for dialing.   When
  3923.     the agenda begins, Robocomm will dial only the non-pursuit systems.
  3924.     Once all non-pursuit systems have been connected with or otherwise
  3925.     removed from the dialing queue, Robocomm will dial the appropriate PC
  3926.     Pursuit indial and begin processing the "pursuitable" systems.
  3927.     Whenever Robocomm is in PC Pursuit dialing mode, you can press [Esc]
  3928.     to bypass the currently selected BBS. Robocomm will ask you if the BBS
  3929.     should be removed from the agenda for this pass.  Answer NO if you
  3930.     want Robocomm to try and dial this number again the next time it comes
  3931.     up in the dialing queue.
  3932.  
  3933.     When Robocomm is on-line with a BBS, the following keys are active:
  3934.  
  3935.          [F1]      Pressing [F1] while Robocomm is on-line with a BBS will
  3936.                    cause you to "jump" temporarily to Robocomm's ANSI
  3937.                    terminal.  This is often useful for doing things like
  3938.                    resetting your message pointers inside the mail door or
  3939.                    doing a quick ad-hoc search for and download of a file.
  3940.                    See the ANSI Terminal section of this manual for more
  3941.                    information on the features of the terminal.
  3942.  
  3943.                    When you have finished in the ANSI terminal, just press
  3944.                    [Alt-X] and you will be returned to unattended
  3945.                    communications.
  3946.     ______________________________________________________________________
  3947.     Robocomm 4.0 User's Guide                                      Page 64
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.                    NOTE:     As Robocomm returns from the ANSI terminal,
  3957.                              it sends a carriage return to the BBS.  To
  3958.                              ensure that your agenda picks up properly
  3959.                              from where it left off, make sure to leave
  3960.                              the Terminal at the same prompt Robocomm was
  3961.                              at or approaching before you pressed [F1] to
  3962.                              enter ANSI terminal mode.
  3963.  
  3964.  
  3965.  
  3966.  
  3967.          [F3]      If you press the [F3] function key while Robocomm is
  3968.                    on-line with a BBS, Robocomm will immediately hang up
  3969.                    on the BBS and return to the main menu. Remember, you
  3970.                    can pick up again right from where you left off by
  3971.                    restarting the agenda with a "Go" command, even if
  3972.                    you've quit Robocomm and restarted it again.   However,
  3973.                    you might want to review the agenda on-screen first
  3974.                    because the agenda item that was executing when you
  3975.                    pressed F3 will have been marked as an error and will
  3976.                    not be  re-attempted until it has been reset.
  3977.  
  3978.          [F10]          Pressing [F10] while on-line with a BBS toggles
  3979.                    the "Remain On-line" status of that BBS.  When the
  3980.                    words "Remaining On-line" are flashing on the agenda
  3981.                    status title bar, Robocomm will automatically jump to
  3982.                    terminal mode after it has completed all the scheduled
  3983.                    items on its agenda.  If you see something that
  3984.                    requires your attention while an agenda is in process
  3985.                    but don't want to interrupt the agenda while it's in
  3986.                    process press [F10] at any time before Robo finishes
  3987.                    its work.
  3988.  
  3989.  
  3990.  
  3991.  
  3992.                    NOTE: Since Robocomm places only one call to the PC
  3993.                              Pursuit indial to connect with multiple BBS
  3994.                              systems, it is crucial that Robocomm controls
  3995.                              the entire interface with PC Pursuit.  When
  3996.                              connecting with systems through PC Pursuit,
  3997.                              you should always allow Robocomm to log off
  3998.                              the BBS by itself. Robocomm needs to see the
  3999.                              "DISCONNECTED" message from PC Pursuit to
  4000.                              know that it is OK to move on to the next
  4001.                              BBS.  If you are in terminal mode, don't
  4002.                              issue a "G"oodbye command to the BBS.  When
  4003.                              you press Alt-X to return to unattended
  4004.     ______________________________________________________________________
  4005.     Robocomm 4.0 User's Guide                                      Page 65
  4006.  
  4007.  
  4008.  
  4009.  
  4010.                              processing Robo will be looking for messages
  4011.                              from PC Pursuit that may have already
  4012.                              scrolled off the screen while you were in
  4013.                              terminal mode.  This will cause Robocomm to
  4014.                              time out, hang up and redial.
  4015.  
  4016.  
  4017.  
  4018.  
  4019.        USING THE ANSI TERMINAL
  4020.  
  4021.     To enter Robocomm's ANSI terminal, select Terminal from the Go menu or
  4022.     press [F1] or [F10] while Robocomm is on-line during an agenda.  If
  4023.     you are entering the terminal from the main menu, the modem will be
  4024.     initialized and communications to your modem will be established at
  4025.     the Default Baud Rate that you specified on the Communications
  4026.     Configuration screen.  To call up a help screen of terminal options,
  4027.     press the [F1] key at any time while in the terminal.  The following
  4028.     options are available:
  4029.  
  4030.     [Alt-H]   Hang Up - To immediately end communications between the BBS
  4031.               and Robocomm, select "Hang Up" from the terminal menu.
  4032.               Robocomm will first attempt to temporarily drop carrier. If
  4033.               this unsuccessful in breaking the connection, Robocomm will
  4034.               send the "Hang Up String" you specified on the "Configure-
  4035.               General" menu.
  4036.  
  4037.     [Alt-D]   Dial - To activate Robocomm's Demon Dialer feature, press
  4038.               [Alt-D] while in the terminal mode.  A window will open up
  4039.               listing all your configured BBS systems that are not
  4040.               accessed via PC Pursuit.   Highlight the systems you would
  4041.               like to dial and press the space bar.  When all of the
  4042.               systems you want to dial are tagged, press [Enter] to start
  4043.               dialing.
  4044.  
  4045.     [Alt-B]   Set Baud - Select "Baud" to change the current baud rate of
  4046.               the terminal.  Robocomm operates only at "no parity", "eight
  4047.               data bits" and "1 stop bit".
  4048.  
  4049.     [Alt-C]   Clear the Screen
  4050.  
  4051.     [Alt-L]        Printer Logging - To send terminal text to the printer
  4052.               as well as the screen, press [Alt-L].  When printer logging
  4053.               is active, pressing [Alt-L] again will disable it.
  4054.  
  4055.     [Alt-C]   Capture File - To send terminal text to a capture file that
  4056.               you specify, press [Alt-C].  Once capturing is active, you
  4057.               can disable it by pressing [Alt-C] again.
  4058.  
  4059.     [Alt-P]   Send Password - Press [Alt-P] to send your password for the
  4060.               current BBS.
  4061.  
  4062.     ______________________________________________________________________
  4063.     Robocomm 4.0 User's Guide                                      Page 66
  4064.  
  4065.  
  4066.  
  4067.  
  4068.     [Alt-R]   Send Break - Used to send a one second BREAK signal to the
  4069.               modem.
  4070.  
  4071.     [Alt =]        DOORWAY Mode is used by some BBS systems to allow the
  4072.               remote machine to send most all of the keys on its keyboard
  4073.               to the host (BBS) computer.  To enable this mode in
  4074.               Robocomm's terminal, hold down the [Alt] key and press.  You
  4075.               should use this feature whenever you are using the "visual"
  4076.               editor on the BBS.  It will allow all of your standard arrow
  4077.               and editing keys to function as you would expect.
  4078.  
  4079.  
  4080.  
  4081.  
  4082.               NOTE:     Once DOORWAY mode has been activated, the only way
  4083.                         to exit the terminal or issue any other terminal
  4084.                         command is to toggle the mode off with [Alt =].
  4085.  
  4086.  
  4087.  
  4088.  
  4089.     [Alt-X]   Exit Terminal Mode
  4090.  
  4091.     [F7]           Shell to DOS - To temporarily exit to DOS from the
  4092.               Robocomm terminal, select "DOS Shell" from the terminal
  4093.               menu.  When you do this, Robocomm will attempt to free up
  4094.               the amount of RAM you have specified in your "RAM for Mail
  4095.               Reader" option of the utility configuration menu.  If
  4096.               insufficient disk space is available, Robocomm will free up
  4097.               as much RAM as possible and place you at a DOS prompt. When
  4098.               you have finished, type EXIT at any DOS prompt and you will
  4099.               be returned to the ANSI terminal.
  4100.  
  4101.     PgUp      Upload - To Upload a file using Robocomm's internal ZMODEM,
  4102.               YMODEM, YMODEM-G or ROBORZ.BAT file, select this option.
  4103.               You will be prompted for the file name to send. Pressing
  4104.               [F10] at the prompt will pop-up a pick list of files
  4105.               matching the file specification in the field.
  4106.  
  4107.     PgDn      Download - To download a file using Robocomm's internal
  4108.               ZMODEM, YMODEM or YMODEM-G, use this option.  The file(s)
  4109.               received will be placed in your configured "Download
  4110.               Directory."
  4111.  
  4112.     AUTOMATIC ZMODEM DOWNLOADS - Robocomm can automatically detect the
  4113.     sequence of characters used by Zmodem to indicate the start of a file
  4114.     download.  By default, Robocomm uses it's own internal Zmodem for
  4115.     auto-downloads.  If you would prefer to use DSZ or some other external
  4116.     Zmodem protocol engine, you will need to create a Z-AUTO.BAT file in
  4117.     your Robocomm directory.  If Z-AUTO.BAT exists in the Robocomm
  4118.     directory when the time comes to initiate an automatic download,
  4119.     Robocomm will change directories to your configured download directory
  4120.     ______________________________________________________________________
  4121.     Robocomm 4.0 User's Guide                                      Page 67
  4122.  
  4123.  
  4124.  
  4125.  
  4126.     and then shell to DOS, calling the Z-AUTO.BAT file.  For this reason
  4127.     it is essential that your Robocomm directory be included in your path
  4128.     statement. If it isn't, DOS will report a "Bad command" message
  4129.     because it can't locate Z-AUTO.BAT.  The following batch file
  4130.     implements a Zmodem auto-download using DSZ:
  4131.  
  4132.          DSZ port %1 speed %2 rz -m
  4133.  
  4134.     AUTOMATIC HS/LINK DOWNLOADS - HS/Link auto-downloads work differently
  4135.     than Zmodem auto-downloads in that Robocomm looks for a HS-AUTO.BAT
  4136.     file and Robocomm sends the path for downloaded files as the %4
  4137.     parameter.  Thus, the default HS-AUTO.BAT file that is shipped with
  4138.     Robocomm is:
  4139.  
  4140.     HSLINK -P%1 -B%2 -R -O -HS -! -U%4
  4141.  
  4142.        VIEWING & MANAGING THE FILE DIRECTORIES
  4143.  
  4144.     Robocomm automatically creates entries in two files directories for
  4145.     you.  The "Downloaded Files" directory holds information on the files
  4146.     you have downloaded or uploaded using Robocomm.  The "Available Files"
  4147.     directory holds information on files available for download on the BBS
  4148.     systems that you call.
  4149.  
  4150.     Entries are added to the New Files directory when you do "New File
  4151.     Scans" as part of an agenda, or if you set up a mail door to scan new
  4152.     files for you.  If a file listing received in a new files scan is
  4153.     already part of your list (from the same BBS) or if the file is found
  4154.     in your Downloaded Files directory (from any BBS) then Robocomm will
  4155.     not add a record to your New Files directory for that file.
  4156.  
  4157.     You can view the Available Files directory in one of two ways.  From
  4158.     the main menu, select Directory followed by Available Files.
  4159.     Alternatively, you can view the files directory while creating a
  4160.     download file agenda item by pressing [F10] at the "File Name:"
  4161.     prompt.  Similarly, you can view the Downloaded Files directory by
  4162.     selecting Directory followed by Downloaded Files from the main menu.
  4163.     Or, you can press [F10] at the "Upload File" prompt on the agenda
  4164.     editing screen.  Here, we see a New Files directory stocked full of
  4165.     goodies to download:
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.     ______________________________________________________________________
  4179.     Robocomm 4.0 User's Guide                                      Page 68
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.     When the Available Files Directory is shown on the screen, the
  4208.     following keys are active:
  4209.  
  4210.     BULK DELETE - Press  B  from either file directory screen to bring up
  4211.     the Bulk Delete window.  This command allows you to mark file entries
  4212.     from specific systems and/or before a specific date for deletion.
  4213.     File entries marked for deletion will appear in dark text (on color
  4214.     systems only) and the word DEL will appear to the right of the file
  4215.     name. To permanently remove these files from the list use the Clean Up
  4216.     command or select the Pack option when quitting Robocomm.  If you mark
  4217.     a file as deleted and want to return it to normal status, highlight it
  4218.     and press  Del .
  4219.  
  4220.  
  4221.  
  4222.  
  4223.          NOTE:     The Bulk Delete command does not touch any files that
  4224.                    have been tagged with "Keep" status.
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.     DATABASE CLEAN UP - You can permanently delete all files marked for
  4231.     deletion by pressing C in either the Available Files or Downloaded
  4232.     Files directories.  After confirmation, the clean up process will
  4233.     begin and a bar graph will display Robocomm's progress.  The Clean-Up
  4234.     operation cannot be interrupted.
  4235.  
  4236.     ______________________________________________________________________
  4237.     Robocomm 4.0 User's Guide                                      Page 69
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.          WARNING:  Do not re-boot or shut off your computer while Robocomm
  4246.                    is cleaning up its data files.  If you do, you will
  4247.                    most likely loose a portion of your file list data.  In
  4248.                    the event of a power loss during PACK or CLEAN UP
  4249.                    operations, you should immediately re-start Robocomm
  4250.                    with the /P switch.
  4251.  
  4252.  
  4253.  
  4254.  
  4255.     FINDING FILES - Press  [F]  to search for keywords within either files
  4256.     directory.  Input as many keywords as you like, separated by spaces,
  4257.     into the input field and press [Enter] to begin the search. Robocomm
  4258.     will rapidly scan the file name, BBS ID and description associated
  4259.     with the files in the current directory and display only those records
  4260.     in which all your specified keywords were found.
  4261.  
  4262.     Once the matching records are displayed, you may scroll through and
  4263.     tag them as normal.  To return to a display of all files, press  [S]
  4264.     and pick a new sort criteria.
  4265.  
  4266.     When the sort method is other than "Search Text", you can quickly jump
  4267.     to the previous and next search matches by holding down [Ctrl] and
  4268.     pressing the up and down arrow keys or  [Ctrl-P] and [Ctrl-N] .
  4269.  
  4270.  
  4271.  
  4272.  
  4273.          NOTE:     The number of seconds required for the search is
  4274.                    displayed on the top of the screen after each search.
  4275.                    This is to assist you in optimizing the search speed on
  4276.                    your system. The speed of your keyword search can vary
  4277.                    significantly depending upon your FTS (Fast Text
  4278.                    Search) Index file and EMS (Expanded Memory) allocation
  4279.                    configuration settings. See the FTS Index Notes for
  4280.                    hints on optimizing your setup.
  4281.  
  4282.  
  4283.  
  4284.  
  4285.     EDITING FILE DESCRIPTIONS - To edit any file's description, simply
  4286.     highlight the file and press [E].  Robocomm will pop-up a small editor
  4287.     for your use.  When you are satisfied with the description, press
  4288.     [Ctrl-Enter] to save it to disk.
  4289.  
  4290.     TAGGING AND "KEEPING" FILES - All files in Robocomm's file listings
  4291.     can have a combination of two file tags.  Pressing the space bar will
  4292.     tag/untag a file for group operations, such as uploading and
  4293.     downloading.  Pressing the [K] key will tag/untag a file's "Keep"
  4294.     ______________________________________________________________________
  4295.     Robocomm 4.0 User's Guide                                      Page 70
  4296.  
  4297.  
  4298.  
  4299.  
  4300.     status.  File entries with "Keep" status are never removed from the
  4301.     file directory.  They remain until explicitly marked for deletion with
  4302.     the DEL key or, in the case of downloads, when the file is downloaded.
  4303.     The "Keep" status is ideal for files that you think you will want to
  4304.     download at a later time.  Once these type of files are tagged with
  4305.     the "K" key you are free to use the bulk erase and zap commands to
  4306.     remove large quantities of unwanted files from the list.  The files
  4307.     with keep status will remain long after the transient files are
  4308.     removed from the list.
  4309.  
  4310.     The [+] and [-] keys can be used to apply or remove both types of tags
  4311.     to a file.  If you see a file you want to download and you anticipate
  4312.     that you will be cleaning out the file directory between the time you
  4313.     create a download agenda item and the time the file is downloaded,
  4314.     then you will need to tag it for downloading and also give it keep
  4315.     status.  The [+] key automates this process to one keystroke.
  4316.     Conversely, the [-] key removes all tags from an individual file
  4317.     listing.
  4318.  
  4319.     Several keys are available for quick manipulation of the standard tags
  4320.     on many files at once.  [Ctrl-T] will tag all files in the list
  4321.     automatically, [Ctrl-U] will untag all file listings and [Ctrl-I] will
  4322.     invert the tags.
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.          NOTE:     Robocomm assumes you want to Keep all file listings in
  4329.                    your Downloads directory.  References in this section
  4330.                    to the "Keep" flag apply only to the New Files
  4331.                    directory.
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.     JUMPING AROUND - To jump to the first file beginning with a specific
  4338.     letter, put the listing into file name order with the "S" key, then
  4339.     press [Alt-J] (for "jump") followed by the letter you wish to jump to.
  4340.     To move to the first file in the directory, press [Ctrl-PgUp].  To
  4341.     move to the last file, press [Ctrl-PgDn].
  4342.  
  4343.     DELETING ENTRIES - To delete a listing from either file directory,
  4344.     highlight the file name and press the [Del] key.  The word "DEL" will
  4345.     appear on the listing.  To "un-delete" an entry simply highlight the
  4346.     DELeted file and press [Del] again.  If you are in the Downloads
  4347.     directory, Robocomm will ask you if you also want to permanently
  4348.     delete the downloaded file from disk.  DELeted files are not actually
  4349.     removed from the directory until you issue a "C" command to clean up
  4350.     the database or until you exit Robocomm and select "Pack" before exit.
  4351.  
  4352.     ______________________________________________________________________
  4353.     Robocomm 4.0 User's Guide                                      Page 71
  4354.  
  4355.  
  4356.  
  4357.  
  4358.     ZAPPING THE DIRECTORY - To mark as DELeted all files that have not
  4359.     been given "Keep" status, simply press the [Z] key.
  4360.  
  4361.     MOVING FILES OFFLINE - Robocomm includes a functional floppy disk
  4362.     cataloging system that will allow you to archive your downloaded files
  4363.     offline and easily recall them for use or for uploading to a system.
  4364.     This function is activated with the "O" key while in the Downloads
  4365.     Directory.  It will move the highlighted file to a diskette in the
  4366.     drive you specified in the "Offline Files Drive" option on the "Data &
  4367.     Logs" configuration screen.  THE DISKETTE MUST ALREADY HAVE BEEN
  4368.     FORMATTED!  Don't forget that you can press [F7] if you need to drop
  4369.     to DOS to format a disk.
  4370.  
  4371.     If the diskette doesn't already have a Volume label, Robocomm will
  4372.     prompt you for one.  Once the file is on the diskette, the status
  4373.     display for that file will indicate "Offline" and the location display
  4374.     will indicate the diskette that the file is located on.
  4375.  
  4376.     MOVING FILES ON-LINE - To move a file off a diskette and back into
  4377.     your "Downloads" directory, highlight a file that is displayed as
  4378.     being "Offline", insert the appropriate diskette in your offline files
  4379.     drive and press the "O" key.  Robocomm will copy the file back onto
  4380.     your hard disk.  This step really isn't necessary however, because
  4381.     Robocomm will automatically prompt you to insert the appropriate disk
  4382.     if you attempt to upload a file that has been moved offline.  In this
  4383.     instance, the file status will be marked as "Pending Upload."
  4384.  
  4385.     VIEWING DOWNLOADED FILES - To view a compressed or GIF image file that
  4386.     has been downloaded, simply highlight it in the Downloads directory
  4387.     and press [V].  Robocomm will swap itself to disk or expanded memory
  4388.     and call the program that you specified on the Utility Configuration
  4389.     screen to view the file.  When you are finished with the file view,
  4390.     simply quit the program and you will be returned to Robocomm.
  4391.  
  4392.     TESTING DOWNLOADED FILES - Robocomm also allows you to test and scan a
  4393.     downloaded compressed file directly from the Download Directory.  To
  4394.     do this, highlight the file name and press the [T] key. Robocomm will
  4395.     swap itself to disk or expanded memory and call up a batch file called
  4396.     TESTFILE.BAT.  Robocomm sends the following parameters to the batch
  4397.     file:
  4398.  
  4399.          %1   The full path and name of the file to test
  4400.  
  4401.          %2   The extension of the file type (Usually this will be ZIP,
  4402.               ARC, or LZH)
  4403.  
  4404.     A sample TESTFILE.BAT is supplied with Robocomm.  It switches to a
  4405.     temporary directory, decompresses the file, runs McAfee's SCAN.EXE
  4406.     program, pauses, calls a transient copy of your %COMSPEC% and allows
  4407.     you to play.  When you're done with the file, a quick DEL *.* followed
  4408.     by EXIT will whisk you back to Robocomm, where you may be inclined to
  4409.     OFFLINE, DELete, UPLOAD or simply ignore the file.
  4410.     ______________________________________________________________________
  4411.     Robocomm 4.0 User's Guide                                      Page 72
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.        ECHO OFF
  4418.        REM TESTFILE.BAT - Robocomm file testing batch file
  4419.        REM %1 = Filename (Including Path)
  4420.        REM %2 = Type of file (The file's extension)
  4421.        md ROBOTEMP>nul
  4422.        cd ROBOTEMP
  4423.        IF %2 == ZIP GOTO UNZIP
  4424.        IF %2 == LZH GOTO UNLZH
  4425.        IF %2 == ARC GOTO UNARC
  4426.        GOTO ERROR
  4427.        :UNZIP
  4428.        PKUNZIP %1
  4429.        GOTO DONE
  4430.        :UNARC
  4431.        PKUNPAK %1
  4432.        GOTO DONE
  4433.        :UNLZH
  4434.        LHARC x %1
  4435.        GOTO DONE
  4436.        :ERROR
  4437.        CLS
  4438.        ECHO %1 IS AN UNKNOWN FILE TYPE
  4439.        ECHO (You may want to edit your TESTFILE.BAT file)
  4440.        ECHO Parameter 1 was [%1]
  4441.        ECHO Parameter 2 was [%2]
  4442.        ECHO
  4443.        pause
  4444.        GOTO END
  4445.        :DONE
  4446.        REM Use McAfee's viral scan to test the file for critters
  4447.        REM /A = Scan all files
  4448.        REM /nomem = Skip the memory scan
  4449.        CLS
  4450.        SCAN *.* /A /nomem
  4451.        pause
  4452.        PROMPT Type EXIT to return to Robocomm$_$P$G
  4453.        %COMSPEC%
  4454.        :END
  4455.  
  4456.     IMPORTING NEW FILES LISTINGS FROM OTHER SOURCES - Robocomm can import
  4457.     any text file which contains a files listing in the standard PCBoard
  4458.     or Wildcat Double line format.  Many BBS systems make a file available
  4459.     for download which contains a compressed listing of all files
  4460.     available on the BBS.  You can download such a file, then go to the
  4461.     New Files directory and press "I" to start the import operation.
  4462.     Robocomm will prompt you for the filename to import and also the name
  4463.     of the BBS that has these files.  Robocomm will then check the list
  4464.     for files that aren't already listed in your Downloads directory or
  4465.     your New Files listing and add them. Remember, Robocomm's file
  4466.     listings can grow to any size, and are only limited by your available
  4467.     disk space!  You'll still get lighting quick sorts and file access, so
  4468.     ______________________________________________________________________
  4469.     Robocomm 4.0 User's Guide                                      Page 73
  4470.  
  4471.  
  4472.  
  4473.  
  4474.     feel free to import as many listings as you want.
  4475.  
  4476.     Assigning Conferences in Imported Text Files - If you would like
  4477.     conference numbers/names to appear in file listings you "I"mport into
  4478.     the available files directory, you need to edit the files to include
  4479.     the following marker:
  4480.  
  4481.     CONF
  4482.  
  4483.     The  character is created by holding down the [Alt] key and typing 16
  4484.     on the numeric keyboard.
  4485.  
  4486.     For example, to edit a file listing to show that all subsequently
  4487.     listed files can be found in the WINDOWS conference, you would include
  4488.     the following label in the text file, starting in column 1:
  4489.  
  4490.     CONFWINDOWS
  4491.  
  4492.     A directory listing may include any number of these markers.  All
  4493.     files found subsequent to a marker will have the indicated conference
  4494.     included in their conference field, which is automatically supplied
  4495.     when the file is selected for downloading.  The conference name may be
  4496.     up to 13 characters in length.
  4497.  
  4498.  
  4499.  
  4500.  
  4501.          NOTE:     Be careful that you do not attempt to import a PCBoard
  4502.                    file listing from a Wildcat system and vice-versa.
  4503.                    Robocomm assumes that the file list you specify is in
  4504.                    the native format of the BBS system you specify.
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.     WRITING TO PCBOARD FORMAT DIR FILES - Use the "W" command in either
  4511.     directory to append standard format PCBoard DIR file entries to a
  4512.     specified text file.  If there are files tagged when you press [W],
  4513.     Robocomm will write out descriptions for all tagged files.  If not,
  4514.     then just the currently highlighted file will be written.  You will be
  4515.     given the option of using today's date or the file date when you
  4516.     create append to the DIR files.
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.     ______________________________________________________________________
  4527.     Robocomm 4.0 User's Guide                                      Page 74
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.        READING DOWNLOADED MAIL FILES
  4534.  
  4535.     Robocomm allows you to run your mail packet reader programs by
  4536.     selecting "Read" from the main menu.  Don't forget that your mail
  4537.     reader itself will need to shell out to DOS to run a file compression
  4538.     and decompression utility, so you may need a full 512K (the default)
  4539.     of RAM to run the program.  Specify the amount of memory to free up on
  4540.     the Utility Configuration screen.
  4541.  
  4542.          QWK Messages - A command is executed as specified on the
  4543.          Configure-Utility Screen under the "Command to invoke mail
  4544.          reader" option.
  4545.  
  4546.          Captured Mail - Robocomm will scan your configured "Path for
  4547.          *.QWK packets" for packets with a "PCB" extension and present you
  4548.          with a menu of matching packets.   When you select a packet from
  4549.          the menu, the operation will differ, depending upon whether a
  4550.          file called READPCB.BAT exists in your Robocomm directory.  If
  4551.          READPCB.BAT doesn't exists, then Robocomm will call your
  4552.          configured ZIP file viewing utility to view the file.
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.     ______________________________________________________________________
  4585.     Robocomm 4.0 User's Guide                                      Page 75
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.        OPERATING ROBOCOMM FROM THE COMMAND LINE
  4592.  
  4593.     Robocomm can execute agendas based on command line parameters.  This
  4594.     feature will be particularly valuable for system operators who want to
  4595.     use Robocomm for network mail runs, as part of their BBS's timed
  4596.     event.
  4597.  
  4598.     The syntax for Robocomm's command line switches is:
  4599.  
  4600.     ROBOCOMM /A<agenda> /T<time> /D<date> /R /Lnnnn   [Other Switches]
  4601.  
  4602.     The AGENDA switches are:
  4603.  
  4604.          /A   (Optional) This parameter must be first if it is included in
  4605.               the command line.  /A followed immediately by an agenda name
  4606.               (non-case sensitive) tells Robocomm which agenda to execute.
  4607.               After Robocomm has executed the agenda, it immediately exits
  4608.               back to DOS.
  4609.  
  4610.          /T   (Optional) /T followed immediately by the time (In 24 hour
  4611.               format) to start the agenda specified by the /A parameter.
  4612.               Don't use the /T parameter if you haven't specified an
  4613.               agenda with /A.  If /A is specified and /T is omitted, then
  4614.               the Agenda will be execute immediately.
  4615.  
  4616.          /D   The date that the agenda should begin operating.  Enter it
  4617.               in the following format: MM-DD-YY where MM is the month, DD
  4618.               is the year and YY is the year.
  4619.  
  4620.          /R   (Optional) Tells Robocomm to "reset" the agenda so that all
  4621.               items marked as "done" become "things to do."
  4622.  
  4623.          /Lnnn     Overrides the Redial Attempts Per System configuration
  4624.               option and forces all systems in the current agenda run to
  4625.               be dialed nnn times.
  4626.  
  4627.     The OTHER switches are:
  4628.  
  4629.          /M   (Optional)  Force monochrome mode.  Do not use if the /C
  4630.               command is being used.
  4631.  
  4632.          /C   (Optional)  Force color mode.  Do not use if the /M command
  4633.               is being used.
  4634.  
  4635.          /P   Pack the data files at the conclusion of processing before
  4636.               returning to DOS.
  4637.  
  4638.          /IP  Imports a file containing PCBoard format file listings into
  4639.               Robocomm's Downloads directory.  This feature is helpful for
  4640.               Sysops who would like the contents of their PCBoard upload
  4641.               directory to be available for uploading from Robocomm's
  4642.     ______________________________________________________________________
  4643.     Robocomm 4.0 User's Guide                                      Page 76
  4644.  
  4645.  
  4646.  
  4647.  
  4648.               Downloads list.  For example, on Group One BBS, the nightly
  4649.               event runs Robocomm as follows, to import the BBS's new
  4650.               files list into Robocomm:
  4651.  
  4652.               ROBOCOMM /IPJ:\PCB\MAIN\DIR0
  4653.  
  4654.          /IW  Imports a Wildcat double line format file listing into
  4655.               Robocomm's Downloaded Files directory.  Uses the same syntax
  4656.               as the /IP switch.
  4657.  
  4658.          /O   Causes Robocomm to place the modem off-hook before quitting
  4659.               to DOS.  This causes callers to get a busy signal.
  4660.  
  4661.     Examples:
  4662.  
  4663.     ROBOCOMM /AQMAIL /T5:00 /R    Starts Robocomm and executes an
  4664.                                   agenda called "QMAIL" at 5:00 AM.  In
  4665.                                   addition, Robocomm is instructed to
  4666.                                   reset any "Done" items to "To do"
  4667.                                   status.  Meanwhile, I sleep...
  4668.  
  4669.     ROBOCOMM /AREPLY /R /M /P     Starts the agenda "REPLY" immediately,
  4670.                                   resets all "done" items to "To Do"
  4671.                                   status and forces monochrome mode.  The
  4672.                                   data files will be cleaned up after the
  4673.                                   agenda runs.
  4674.  
  4675.     ROBOCOMM /C                   Forces color mode
  4676.  
  4677.     ROBOCOMM /AEAST /T22:00       Starts the agenda "EAST" at 10 PM.  Only
  4678.                                   those items marked as "To Do" will be
  4679.                                   attempted since no /R switch was used to
  4680.                                   reset the agenda.
  4681.  
  4682.     ROBOCOMM /Afoo /R /L10        Executes the agenda FOO immediately,
  4683.                                   resetting all done items to ToDo status.
  4684.                                   A maximum of 10 dial attempts per system
  4685.                                   is specified.
  4686.  
  4687.  
  4688.        INTERPRETING AND VIEWING THE LOG
  4689.  
  4690.     All of the messages that you see printed in the log window during an
  4691.     on-line session are echoed to a log file if you have one specified in
  4692.     your Robocomm configuration.  Whenever an agenda item is about to be
  4693.     attempted, the name of the agenda item is indicated with the symbol
  4694.     indicating its temporary or permanent status.  The notations that
  4695.     follow indicate the steps that Robocomm took in order to complete the
  4696.     agenda item.  When Robocomm finishes an agenda item, a notation is
  4697.     marked with a check mark if the item was completed successfully and an
  4698.     exclamation mark if there was an error condition.
  4699.  
  4700.     ______________________________________________________________________
  4701.     Robocomm 4.0 User's Guide                                      Page 77
  4702.  
  4703.  
  4704.  
  4705.  
  4706.     You can view the Robocomm log file at any time with the [F8] hot key.
  4707.     Just press this key and Robocomm will call your file browsing utility
  4708.     to view the log.  Alternatively, you can select Read followed by LOG
  4709.     File from the main menu.
  4710.  
  4711.  
  4712.        VIEWING CAPTURE (CAP) FILES
  4713.  
  4714.     Robocomm also includes a hot key for viewing files captured with the
  4715.     Capture Command agenda item.  By pressing [F9] you will be presented
  4716.     with a list of all text files with a .CAP extension in the Robocomm
  4717.     directory.  Use the arrow keys to select the file to view.
  4718.     Alternatively, you can select Read followed by LOG File from the main
  4719.     menu.
  4720.  
  4721.  
  4722.  
  4723.  
  4724.          NOTE:     If you would like to have the Robocomm documentation
  4725.                    available for browsing while using Robocomm, just
  4726.                    rename this file, Robocomm.doc, to Robocomm.cap and
  4727.                    place it in the Robocomm subdirectory.
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.     ______________________________________________________________________
  4759.     Robocomm 4.0 User's Guide                                      Page 78
  4760.